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
_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
