Didou tries to propose some system, where notes will be categorized "to be integrated", so they can sooner become part of the manual.
How does that make them part of the manual sooner? Are doc editors required to look for those tags? Are note/doc people required to work on those categories first?
Just because something is "labeled", does it change anything?
The idea is that people who are not doc authors would be able to edit notes, and doc authors would look at notes marked as "to be integrated" and would integrate those. This is easier for manual authors, as they don't need to go through a pile of notes, the best ones are already selected. It is also easier to work with the notes and not switch from the notes system to phpdoc XML files while integrating some stuff. You only need to click and go form page to page, and mark notes as you see fit. Further on, people can integrate the notes as time permits.
I must point out that I am not in a note maintainer role, so I can only build on the assumptions I have about note maintanance (and on the practice I had ;). The above seems to be sensible to me, but I don't know how more work would this be for note maintainers. I don't have much practice in it.
Our users are mostly convinced that the user notes often contain valuable information (more often than crap). We get requests all the time to integrate them in the downloadable versions. I had created the special CHM version, and the feedback I received always pointed to the great inclusion of the user notes.... This may be an indication that the manual is weak at many places, yes. But it is also an indication IMHO that user notes have their own place.
I don't think that this means the notes are "weak", I think it means that the manual is weak.
I can absolutely agree that our manual can be enhanced in many ways, and really cannot understand guys still saying we have the best manual. IMHO this is not true [yet].
Goba
