> > Specific suggestions for documentation from the session are below. Of > course, everyone bascially wanted more and better documents. > > 1. A document annotation system as discussed earlier, where > one could add a comment/edit at the end of a doc > viewers could see the comments even if the doc owner hasn't > revised he doc to include them > the comments would be delted after the doc owner has decided > what to do with the comment > > 2. Better (much better) indicators for out-of-date info. > 3. A way for people to note errors, corrections, improvements without > needing to pull and build the CVS doc tree, and without having to get > CVS write access. > 4. A way for the info in the weekly status reports to be more accessible.
not meaning to be devil's advocate here, but has anyone taken a look recently as to how we do documentation at php.net ? we use the sgml docbook format, and generate pages accordingly. We have a notes system, so people can annotate / comment on, which get reviewed by the documentators (with edit/delete/reject tools) ? This could be made accessible if it's usefull... -- james
