Archives for: March 2006, 07

Mar 07, 2006 : Wikis: tagging releases and building distributable docs

I want to create project documentation on a wiki, and be able to build well-versioned, distributable releases. I've yet to find a wiki that can do this.

First, you have to be able to generate stand-alone documents (preferably HTML or PDF) that are still navigable and usable (i.e. not just a big dump of the wiki). Some wikis do this.

Second, you have need to store the documents in a versioned repository. One like subversion, that will support tags. You should be able to tag the whole wiki as "release-0.3" and then be able to browse the whole wiki as it was at that release and be able to rebuild that release's PDF/HTML docs. Subwiki seems to be dead; Kwiki has a SVK (distributed SVN) plugin, but I haven't tested it yet and I doubt you can browse "at" a tagged release.

<  March 2006  >
Mon Tue Wed Thu Fri Sat Sun
    1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30 31    




Syndicate this blog XML

powered by