From: Emily Winch (boost_at_[hidden])
Date: 2002-11-24 15:43:31
Aleksey Gurtovoy wrote:
> David Abrahams wrote:
> >"Jeff Garland" writes:
> >>4) The MPL team used another Wiki to develop documentation.
> >>Not sure how that worked. Aleksey care to comment?
> >I can tell you that it ended up being pretty one-sided. It was great
> >for Aleksey - he had the whole Wiki on his local machine
> To clarify - at one point of time; when things were moved to
> www.mywikinet.com, I lost my privileges :).
> I'll let Emily speak for herself, but IMO the collaboration part of doing
> the docs in Wiki works pretty good. The main reason I switched to DocBook
> later was the lack of the semantic/structural markup and all the nice
> benefits it brings along (different output formats, automatic TOC
> generation, better cross-reference capabilities, et al.).
I did quite a bit of re-arranging and editing of the existing material,
and for this the Wiki was very useful. I'd guess that for documentation
in the early stages, with frequent major updates and rewrites, a Wiki
would be ideal. I'm not convinced it would be useful for established
documentation where changes are usually limited to bug fixes.
Now all you need is a DocBook Wiki :)
> >and could edit pages in his favorite editor
> Actually I _always_ edit them in the edit box in browser; it doesn't
> me much.
Not a problem for me either. If I was adding a lot of new text I think
I'd write it in vi and cut-and-paste but that isn't difficult.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk