outrun, cool!Will try to leave a couple of comments later; in the meanwhile, just wanted to link to a couple of resource that might come in handy.There's a very interesting discussion going on right now on boost-docs mailing list:http://comments.gmane.org/gmane.comp.li ... n/4564Some gems from there:Documentation is freaking awesome // just great!Top ten reasons why I won't use your open source project // might be a good checklist for us!MathJax -- especially this: http://www.mathjax.org/demos/copy-and-paste/Boost.Asio docs as an exemplar case -- some good examples there: http://permalink.gmane.org/gmane.comp.l ... 25Creating Boost HTML and PDF documentation using Quickbook, Doxygen and Auto-Indexinghttp://svn.boost.org/svn/boost/sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index/doc/quick_auto_dox_index.pdfhttp://svn.boost.org/svn/boost/sandbox/tools/quick_auto_dox_index/boost/quick_auto_dox_index/quick_auto_dox_index.hppAt some point having an equivalent to this could be useful ("a template that others can use to get started quickly"):"mylibrary - a template for Creating Boost HTML and PDF documentation using Quickbook, Doxygen and Auto-Indexing"http://svn.boost.org/svn/boost/sandbox/ ... fAutoIndex looks interesting -- http://svn.boost.org/svn/boost/sandbox/ ... index.html

MetaCPAN -- (Perl) modules documentation search engine -- looks pretty cool:http://szabgab.com/blog/2011/07/metacpa ... e.htmlMore content here (video in Japanese, but the slides are mostly in English):