V2 docs: some suggestions

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-06-25 08:16:06

Over time, a lot of users said it's hard to find information in V2 docs. I've 
now took the time to rearrange the docs a bit and would like to hear your 
opinions. 

I think there should be tutorial (which shows how cool V2 is), user manual 
(which has nice overview of all major functionality user will need and links 
to detailed docs), and reference (which might not be very nice to read from 
top to buttom and not very good structured, but still have all the details).

The user manual will be structured into "configuration", "wrining jamfiles" 
and "build process" sections.

I've tried to rearrange the manual, and the results are at:

http://zigzag.cs.msu.su:7813/Boost.Build.docs/bbv2.advanced.html

I'm very interested in your opinion on this approach to structure? Is it good, 
bad, or just as bad as the current docs?

- Volodya