Re: [PHP-DOC] Dealing with the PHP manual annotations (was Re: [PHP-QA] Just a tiny thing) From: Jesus Castagnetto (jmcastagnetto <email protected>)
Date: 07/27/00

Just my 0.02,

I am not sure if I would be able to help weed out the non-relevant
annotations on a regular basis, but you can count me in for helping
with this task.

Some ideas:

For what I've read there is a proposition on making this annotations
moderated. This would be a possibility if we can get a group of people
to act as editors. The annotation would go to the editors, and the
submitter will recieve an e-mail once the annotation is approved. A
web interface for this is doable.

On the subject of a web interface to manage/edit annotations. Lot of
the notes that are there now are support questions, and some should be
entries in the FAQ or in the PHP knowledge base (in particular the
ones that have been answered correctly), whereas others should be sent
to the bug database.

We could then include links to a FAQ (maybe a faq-o-matic type one),
the Knowledge base and the bug database in the notes submission form,
so people have the option to use those resources. A simple paragraph
indicating that support questions should be posted to the Knowledge
base (or the PHP mailing list), abd bugs should be submitted to
bugs.php.net would suffice.

When weeding through the existing notes, it would be nice if there
were an option so if an editor considers that a note is really a bug
report, he/she can just send the contents to the bugs database, and an
email be sent to the person who submitted the info.

--- Jesus M. Castagnetto
-------------------------------------------------
Created by Zkey.com - http://www.zkey.com
Awarded PCMagazine's Editors' Choice