Quickbook needs Users Guide documentation

[Beman Dawes]

Quickbook is currently a disaster to learn to use. The markup itself seems easy, and the "Chapter 33. Quickbook 1.5" docs are fine as far as they go. But without a Users Guide, a new user is left groping in the dark.

A Users Guide should answer the question "How do I build my docs?". It should begin with the simplest possible example .qbk and Jamfile, and then progress from there. It should include a description and examples of how to invoke bjam to build QB docs.

This ticket is a superset of #1205

[anonymous]

I've started at:

​https://svn.boost.org/svn/boost/branches/quickbook-dev/tools/doc-guide/

But haven't got very far yet. So far I've just imported the setup documentation from the wiki.

[Marshall Clow]

Beman -

I started with the example here: ​https://svn.boost.org/svn/boost/sandbox/guild/mylibrary/

[Daniel James]

Current work is at: ​http://boost-sandbox.sourceforge.net/doc/html/boost_doc_tools.html. There's a broken image that won't be broken when properly released.