[Mulgara-dev] documentation wiki

[Leif Johansson]

thomas wrote:
> hi all,
>
> i started working on transfering the documentation into a manageable 
> state again. i already did a lot of search and replace (or destroy) to 
> eliminate some idiosyncracies of the old html code. i also 
> consolidated all the navigation files into one document, which is 
> attached. if anybody feels inclined to check if some pages got lost 
> during the process i would be very grateful. i don't know any way to 
> check this automatically and since this is the backbone of the new 
> site...
>
>
> but i 've got a problem now that i'd like to discuss: as far as i can 
> see the confluence wiki doesn't support a site layout with a 
> navigation tree on every page (be it at the left, as usual, at the 
> top, in a frame or anywhere else). i think that's a showstopper. the 
> documentation is about 185 pages (if i counted correctly) and such a 
> massive amount of text needs good navigational infrastructure. 
> confluence can only provide an extra page with a list of available 
> documents - sorted hierarchically, and that's it. if anybody knows of 
> a way to produce such a navigational element please tell me! otherwise 
> i would suggest to switch from confluence to daisy 
> <http://cocoondev.org/daisy/index.html>.
> i'm more reluctant than it may seem to push the daisy wiki since i 
> don't really know it that much and i can understand that you don't 
> like the idea of getting accustomed to yet another (rather unknown) 
> wiki. but i really think the daisy wiki is better than the confluence 
> wiki.

Why not do the canonical thing (TM) and switch the project over to maven 
and use
the maven site plugin both for building the public site and the 
documentation shipped
with a distribution? Building documentation in a wiki sounds great but 
it'll soon feel
old especially if you have the ambition to produce something coherent.

Maven would also bring so many benefits to the project *and* to everyone 
who wants
to depend on mulgara.

    Cheers Leif