https://svn.boost.org/trac10/ticket/5391 <p> There's lots of complaints about the BBv2 documentation Artyom had the good recommendation to structure it as: </p> <ol><li>General Concepts: <ol class="loweralpha"><li>Syntax </li><li>Rules </li><li>etc. </li></ol></li></ol><ol start="2"><li>Tutorial How to do common stuff: <ol class="loweralpha"><li>Build a program </li><li>Build a library </li><li>Build a test </li><li>Configure things conditionally </li><li>Create extensions </li><li>And so on. </li></ol></li></ol><blockquote> <blockquote> <p> Pass on common features of Autotools, CMake, SCons and make sure users can easily figure out how to do. </p> </blockquote> </blockquote> <ol start="3"><li><strong>Full</strong> reference documentation: <ol class="loweralpha"><li>Properties </li><li>Modules </li><li>Rules </li></ol></li></ol><blockquote> <blockquote> <p> And so on. This is even more important then tutorial because user and search for specific functions rules if they documented but he can't if there is no docs. </p> </blockquote> </blockquote> <blockquote> <blockquote> <p> As example I can provide ICU, their tutorials are very poor and basic but their reference docs are really great. </p> </blockquote> </blockquote> en-us /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/5391 Trac 1.4.3 René Rivera Thu, 31 Mar 2011 00:53:25 GMT https://svn.boost.org/trac10/ticket/5391#comment:1 https://svn.boost.org/trac10/ticket/5391#comment:1 <ul> <li><strong>owner</strong> set to <span class="trac-author">Vladimir Prus</span> </li> <li><strong>component</strong> <span class="trac-field-old">None</span> → <span class="trac-field-new">build</span> </li> </ul> Ticket Mateusz Loskot Fri, 25 Oct 2013 18:57:07 GMT https://svn.boost.org/trac10/ticket/5391#comment:2 https://svn.boost.org/trac10/ticket/5391#comment:2 <ul> <li><strong>cc</strong> <span class="trac-author">mateusz@…</span> added </li> </ul> Ticket