On Jan 30, 2004, at 2:20 PM, Mehdi Achour wrote:
Hi all,
I was thinking about opening a site dedicated to the phpdoc team. This site would have the following goals:
- centralize the efforts of the various contributors.
- provide reference documents:
* list of the undocumented functions
* large TODO
* list of the functions with bad protos, etc
- testing livedocs :
configured with the theme of php.net. This will help us working on replacing the old build system with livedocs.
- have an independent bug system ?
- have the new note management system here (the interface for viewing the notes marked as "to integrate")
I think is a great idea. A Todo and "work in progress by $team_name" would help a newbie to docs (like me) to concentrate on priorities and to stay away from something which currently is in progress.
The idea would be to have a checkout of phpdoc, livedocs and php-src.
Some cron magic will do regular updates on the checkouts and the reference documents mentionned above.
A member of the team connected to the site could at a single glance see the changes which occurred, the TODO tasks that we are focusing on, the help which he could bring, etc etc.
It would be nice to have the documentation howto there with some additions (for new commers) as suggested by Derek (Lateralus) when he joined the team. We can see what problems are facing the new commers and update the howto consequently.
I would like (if I have a favorable answer from systems), to have it hosted at http://doc.php.net/.
If not, I think that I would put my hand in my pocket to take a pretty domain name and that it will be opened to all the contributions.
Any comments ? :)
I am not experienced enough to comment extensively but , if I can help (e.g. financially for a dedicated server... meaning a new server just for this project colocated at a major provider with generous bandwidth allocation or anything else) I would be more then willing to do so.
Mehdi Achour
