David Abrahams wrote: > If I consider all the places in our documentation that could benefit > from the sort of professional attention I've been describing, the one > that causes the most problems for people day-to-day is in the > Boost.Build documentation.
I would be happy to work on the Boost.Build documentation. I am a little unclear as to which specific pages need the most help, however. This page: http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Build/Documentation_Issues tells me that the manual, which I assume means this: http://boost.org/boost-build2/doc/html/index.html manual, needs to be broken up into three separate documents. I believe I could handle the first two challenges, which are the manuals for users and extenders, but I am not certain that my scripting knowledge extends far enough to prepare a document for expert users. Though I am certainly willing to try. Is this correct? I've also found this page: http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Build_V2/Documentation_Todo which details other tasks needing completion, but again I am unsure of what needs to be done, as some of these pages haven't been updated in quite some time. > The next thing I would ask Ericka to do for us, if she was still > interested, would be to "teach a man how to fish." That is, help us > develop web pages that would consist of guidelines and other > information for Boost authors wishing to write good documentation, > including a totally revamped version of > http://boost.org/more/writingdoc/index.html I would enjoy this project as well, but several questions arise. How many of the subjects need reworking? Is there additional source material that needs to be incorporated? And where do I begin? Ericka Abraham ------------------------------------------------------------------------- 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
