This is an old revision of the document!
Revamping user comments at php.net
Possible mentor: Philip Olson
This task involves rethinking how we handle user comments at php.net. This is mainly (only, currently) done within the PHP manual but it could leak into other areas like at pecl.php.net.
The first task involves defining what a user note is (or should be). Is an example that happens to use strlen() a fine user note for the strlen() documentation? Are examples even appropriate user notes? Is the current moderation system working? Many other questions will arise.
There has been some discussion.
- Several others note doubt
Notes about the current system
The current system was written in the 90's, and contains files spread out in several places throughout the PHP project.
Master: * [[http://svn.php.net/viewvc/web/php-master/trunk/manage/user-notes.php]] * [[http://svn.php.net/viewvc/web/php-master/trunk/manage/notes-alert.php]] (not implemented) * [[http://svn.php.net/viewvc/web/php-master/trunk/note.sql]] * [[http://svn.php.net/viewvc/web/php-master/trunk/entry/user-note.php]] * [[http://svn.php.net/viewvc/web/php-master/trunk/fetch/user-notes.php]] * [[http://svn.php.net/viewvc/web/php-master/trunk/fetch/user-notes-rss.php]] (implemented?) * [[http://svn.php.net/viewvc/web/php-master/trunk/include/note-reasons.inc]] * [[http://svn.php.net/viewvc/web/php-master/trunk/include/alert_lib.inc]] (not implemented) * [[http://svn.php.net/viewvc/web/php-master/trunk/scripts/update-user-notes]] * [[http://svn.php.net/viewvc/web/php-master/trunk/scripts/email-note-summaries]]
Docweb: * [[http://svn.php.net/viewvc/web/doc/trunk/cron/daily/notes_stats]] * [[http://svn.php.net/viewvc/web/doc/trunk/cron/weekly/orphan_notes]] PHP Web: * [[http://svn.php.net/viewvc/web/php/trunk/manual/add-note.php]] * [[http://svn.php.net/viewvc/web/php/trunk/include/shared-manual.inc]]
Note archive (note actions are emailed here): * [[http://news.php.net/php.notes]]