Re: [PHP-DOC] Dealing with the PHP manual annotations (wasRe:[PHP-QA]Just a tiny thing) From: Ron Chmara (ron <email protected>)
Date: 07/28/00

Egon Schmid wrote:
> Jani Taskinen wrote:
> > On Thu, 27 Jul 2000, Ron Chmara wrote:
> > >1. Annotations themselves have feedback, at the bottom of the annotation list.
> > Just one though: What if those annotations were mailed to the php-doc
> > list just like bug-reports are mailed to php-dev? Those are (or
> > should be) after all kind of 'bug-reports' of uncomplete/incorrect documentation?
> > And they could have some kind of info about which document is in question?
> Don't do that. The documentation group will be flooded with e-mails and
> it's right now a mess to keep the different languages uptodate.

Indeed, this is why I suggested a *different* alias/address, to let the core
documentation team focus on handling the primary docs themselves. Undoubtedly,
email feedback will include spam, complaints, flames, support questions's, etc.

The culling and sorting can be managed by the online doc tenders, who can
pass the worthwhile comments to PHP-DOC folks...or, as it seems Rasmus is
suggesting, the annotation tenders could be working with jade/docbook/cvs/xml
themselves, or passing edits on to a jade/docbook/cvs/xml-savvy annotation
team member.

-Bop 

--
Brought to you from boop!, the dual boot Linux/Win95 Compaq Presario 1625
laptop, currently running RedHat 6.1. Your bopping may vary.