Re: documentation maintenance

On 9/12/06 11:14 PM, Stephen Warren wrote:
>> The one thing this new system would lack is the mirroring system,
>> since a wiki can't be mirrored like a set of .html files can.
> 
> Well, the dynamic nature of a wiki couldn't be mirrored, but I don't see
> why the wiki couldn't be "ripped" to a set of static pages which could
> be mirrored (e.g. by the mirror site simply crawling the wiki), or
> potentially even included in a distribution (although I imagine that
> might get complicated).

Good point.  I don't mind if folks use mirroring tools to crawl the 
wiki, but I don't think I'll advertise them since without the search 
functions, dynamic indexing and other things, they will be sort of a 
poor man's set of docs.  We'll see how that goes.  If the code starts 
changing dramatically again and many people are using code that doesn't 
match the docs on the wiki it might make sense to bundle html files with 
the tarballs again.  MoinMoin might have a function to export the site 
as a set of flat html files, and it wouldn't be hard to write a script 
to do that either I don't think.

BTW, this idea came to me when I noticed the Ubuntu Linux project uses 
MoinMoin to maintain their docs and it seems to work well for them --

https://help.ubuntu.com/community/UserDocumentation