Boost logo

Boost :

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
>, 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
> bother
> 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, gregod at, cpdaniel at, john at