[ ... ]
Some good points here :) I'm leaning towards weaning the entire PHP documentation process away from the general php bugs system, as the two just don't seem to be the best of friends. This new notes system can be a big part of the new setup.
Regards, Philip
Have to agree 100% with you Philip the documentation bugs should have its own system, integration with the notes system could work, mark the note as a bug and its sent over to the bug system? Solves 2 problems at once really to be honest I don't like touching the bugs system it seems to be snipers's baby and likely to hurt me if I touch it ;)
I think that we need to distinguish between two things :
- a documentation bug :
IMHO, this one should be handled by bugs.php.net. We could click on a link that automatically will post the bug report with the notes lists email address.
- a note that can be added to the documentation (an example to add, a warning that will avoid confusion, etc.) :
since there is no bug here, we shouldn't create one. IMHO, this is when the new interface is needed. The note would be marked as to be integrated. The note will then hide from the online documentation and show in the browsable interface.
With this interface, someone with good knowledge about the topic and enough karma to phpdoc should be able to browse this kind of notes,
commit some changes and then delete the entry (or mark it as integrated so we can have some statistics)
In regards to the current notes system from a users point of view it's the
best resource out there, people are constantly commenting in irc how much
they are being helped with it, the comments are getting better as people
seem to know what is accepted and not these days, although some more
monitoring could be done better some how as a lot of shitty notes still get
through, bugs etc etc just have a look at some obscure functions some time
Having never seen the email that is sent to rejected letters I cant comment
however there has been a lot of noise on it as of late so I assume its not
up to par, so maybe a complete overhaul is in order?
http://cvs.php.net/co.php/php-master-web/manage/user-notes.php?login=2&r=1.34
see the contents of $reject_text
didou
