Re: [boost] How best to use Wiki (was Sockets)

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 
> 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.

Emily