Re: V2 docs: some suggestions

From: David Abrahams (dave_at_[hidden])
Date: 2004-06-26 13:12:11

Vladimir Prus <ghost_at_[hidden]> writes:

> 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?

I'd like to print it out and browse it on paper. Could you generate
a PDF (since you seem to be using BoostBook anyway)?

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com