[Mulgara-dev] documentation wiki

[thomas]

--On 2. Oktober 2006 00:04:57 +0200 Leif Johansson <leifj at it.su.se> wrote:

> thomas wrote:
>>
>> --On 1. Oktober 2006 13:07:13 -0400 Brian Sletten <brian at bosatsu.net>
>> wrote:
>>
>>> Thomas, can you look into whether the Maven site plugin would work  for
>>> you?
>>
>> i'm not a fan of it. as far as i can see it provides some wiki-like
>> syntax instead of html and some templating mechanism to build a rather
>> static site and that's it. the wikis are much more powerfull (eg
>> versioning, search, access control). and i don't see the benefit. for
>> me at least using the maven site plugin wouldn't mean less work.
>>
> You keep your *entire* project versioned see, including the site
> documentation.

:-) you are right

> If you ask me wiki syntax is overrated but that is just another opinion 
:-)

which i share too.

still it's maybe not a very convenient environment to write in? but in the 
end it's not me who's writing the documentation. so i guess others should 
decide. i just wanted to point out that confluence seriously lacks 
naviagtion capabilities. the maven plug in is better in this respect though 
not very comfortable. given the sluggishness of the editors of both 
confluence and daisy maybe the maven plug in is really a good option? would 
it be easy enough to give people write access? what about comments?


ciao
thomas


mailto:thomas at stray.net
http://stray.net



: accumulated wisdom
. early optimization is the root of many evil [donald e. knuth]
. if you've got a hammer every problem looks like a nail
. there is nothing so practical as a good theory
. lazyness is a virtue