Slashdot Mirror
Community-Driven Documentation for Free Software?
const_k asks: "I'm maintaining TightVNC, a popular free software project. As with many other free and open source projects, there is a problem with having comprehensive documentation. Currently, I'm thinking about launching a sort of community-driven
documentation project, using Wiki as an engine that would help volunteer contributors to write and improve the
documentation. I'd like to know, is it a good idea to use Wiki, and is it possible to achieve decent documentation quality this way? What
software and technologies other free or open source software projects use, and what are the results, in terms of completeness and quality of
the documentation? Any pointers and suggestions would be greatly appreciated."
The Linux From Scratch book has a cvs system in place, and automatically converts to html, xml, txt, ext from the sources (which are TeX now iirc).
Slashdot: Where people pretend to be twice as smart as they really are by behaving like children.
I've found running TikiWiki to be fantastic. Running under the usual LAMP system, it does much more than the atypical wiki; forums, trackers, faq's, dynamic content, image and file galleries, etc etc etc.
I've been using it for building a knowledge base, and all the extras have just been the icing on the cake. Two thumbs up.
Robert Anton Wilson