Yes, we'd all like something like this. People have cited, for instance, the way the PHP manual works.

The reference manual is now generated by docbook, so if there is an open-source tool that someone knows of that can provide this facility, we'd look into it!

On 2008-05-22, at 08:17 EDT, Sebastian Wagner wrote:

hi,

I often would like to add some comments to the documentation and I think I'm not the only one. For example if you use a function xy or LzView and see that something is special about it but no comment on it in the reference, it would be helpfull if there is a *add Comment* function next to each Method. Maybe these comments can go into the *main-docs* and reviewed in some kind
of cycle.
I know that the docs are auto-generated by a tool and it will by some kind of tricky to link comments into it but I think without comments you will loose the *voice of the community* :) and a lot of experience people got who
are using it day-by-day.


sebastian

--
Sebastian Wagner
http://www.webbase-design.de
http://openmeetings.googlecode.com
http://www.laszlo-forum.de
[EMAIL PROTECTED]

Reply via email to