Hi Riaan,
The first and most obvious: 1. How is it done ? Also under which license is the php scripts released that adds User notes.? (none of us knows PHP well enough to do this ourselves)
We have a central server, which collects the notes in a mysql database. The mirror sites send the form as a post request to the central server (tunnel the form submit via PHP to this central server). Then a dump of the notes is created and placed onto the rsync server to be served to the mirror sites, so they can display them for users. That means that code to collect and display the notes exist in the phpdoc and php-master-web modules at cvs.php.net. The code is under the PHP license, and we provide no packaged version of it, nor any support for it.
2. The documents have been created with DocBook XSL stulesheets, would that cause a problem ? (since yours is created from DSSL stylesheets)
The notes are bound to the ids of the documentation pages, so it will work regardless of what presentational tool you use.
3. Do you have any statistics on how many people uses the manual (on php.net -- not the mirros) and how many maintainers are needed to check the notes contributed by users? -- Is it a worth the effort, or is there too much noise ? We do not have very many resources and would find it difficult to spen more than 2 or 3 hours a week in the upkeep of the user notes.
We don't have any stats. It depends on how many people is interested in your manual.
Regards, Gabor Hojtsy
