Re: [PHP-DOC] Dealing with the PHP manual annotations (was Re:[PHP-QA]Just a tiny thing) From: Egon Schmid (eschmid <email protected>)
Date: 07/28/00

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?
>
> This way the documentation group could react much quicker to them. Either
> correcting the documentation or replying to the sender with a proper
> response. Like this: 'This is not documentation issue, please report as
> bug in bugs.php.net', or 'This is corrected in CVS...
>
> But this idea is of course for future annotations only. There is much to
> do with the existing database.

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. All
authors should look into the english xml diffs first before updating the
translated manual. Mails like the one from the bug list are kept in a
database and mails to the phpdoc list not.

-Egon 

-- 
SIX Offene Systeme GmbH · Stuttgart  -  Berlin  -  New York
Sielminger Straße 63   ·    D-70771 Leinfelden-Echterdingen
Fon +49 711 9909164 · Fax +49 711 9909199 http://www.six.de