Hi Dean; OpenWRT.org uses the MoinMoin wiki with a "docbook" plugin. That's collaborative documentation in a wiki with a managable (ie "we might manage to xslt it") output.
FYC Allan On 1/15/07, Dean Michael Berris <[EMAIL PROTECTED]> wrote: > Hi Everyone, > > It might just be me, but I think it's pretty obvious that we need to > generate documentation that's easily accessible and easily editable by > the community at large. I see there's > http://zigzag.cs.msu.su/boost.build/wiki and > http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Build_V2 > -- which one should be used, and is there an effort to actually start > generating (more) documentation about Boost.Build and Boost.Jam ? > > I feel there's nothing wrong with using quickbook+boostbook to > document Boost.Jam and Boost.Build, but downloading the Boost > Distribution and having to wade through how to actually build Boost > and the other tools causes somewhat a circular dependency problem -- > and can be considered a serious barrier to entry. Not to mention that > it's pretty complex to develop documentation collaboratively in this > method, where it takes a considerable while between writing and > copy-editing and eventual release (and even the full cycle). > > Though some of us have been successful and able to figure out how > Boost.Build and Boost.Jam (and even quickbook+boostbook) work, some of > us (me included) have very short attention spans and wouldn't want to > go through all that again just to explain it to someone else. > > So if there isn't already an effort, I would like to volunteer some of > my time going over what we already have and collate information and > have it consolidated somewhere convenient. > > Now the question is, where should I start? > > -- > Dean Michael C. Berris > http://cplusplus-soup.blogspot.com/ > mikhailberis AT gmail DOT com > +63 928 7291459 > > ------------------------------------------------------------------------- > Take Surveys. Earn Cash. Influence the Future of IT > Join SourceForge.net's Techsay panel and you'll get the chance to share your > opinions on IT & business topics through brief surveys - and earn cash > http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV > _______________________________________________ > Boost-docs mailing list > [email protected] > Unsubscribe and other administrative requests: > https://lists.sourceforge.net/lists/listinfo/boost-docs > -- [EMAIL PROTECTED] http://dr.chickenandporn.com/ ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys - and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
