+1, I love the idea.
If you need any help on the development of the website, or with writing, let me know, I'm readily available.
Heh thanks, but we're not yet at this stage :) As everybody (still waiting for a lot of others phpdoc'ers to talk) seems to agree with this idea, I'll try to rewrite and developps the goals of the site. When everyone will be okay (I'm such a dreamer) with this, we'll talk about development ;)
didou
Derek
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")
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 ? :)
Mehdi Achour
