On 8/25/08, Marco van de Voort <[EMAIL PROTECTED]> wrote: > > Personally I despise wiki'ed manuals. They are horrible quality, > over-hyperlinked beasts of ugly. I always get the feeling that those > "everybody hacks away online" manuals are more obsessed with the process > than with the result.
I fully agree. Wiki for manuals on online help just doesn't work. Links could be broken very easily and the help is stuck in a single format and no good for offline usage. > system (people being able to annotate problems in the FPC docs on a per page > basis in wiki style), however it was plagued with technical problems, and > never caught on. > > I still like the principle though. It is still visible on the FPC docs page > (the "with comments" option) Why not simply build a option in the HTML generated by fpdoc, so users can click on a link at the bottom of the page or even better, next to each paragraph (something like [edit] in wiki pages), which then emails the documentation maintainers (customisable option) with the comment/fix/suggestion for that documentation paragraph. The doc maintainers can then update the fpdoc (source) documentation. I believe the MSDN help has such a feature as well. Regards, - Graeme - _______________________________________________ fpGUI - a cross-platform Free Pascal GUI toolkit http://opensoft.homeip.net/fpgui/ _______________________________________________ fpc-devel maillist - [email protected] http://lists.freepascal.org/mailman/listinfo/fpc-devel
