Re: [jamboost] Re: [BBv2 doc editorial] Tutorial

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-09-20 17:19:43

David Abrahams wrote:
> Andrey Melnikov <melnikov_at_[hidden]> writes:
> 
>>Look at my Getting Started Guide: http://tinyurl.com/bcgwf
>>It isn't perfect, but I think some ideas can be taken from there.
> 
> 
> I like that page a lot, but I'm pretty sure that usage of the glob
> rule in the first example is wrong.

The "Key advantages" section and the Migration Guide aren't tutorials. 
Indeed, they are a kind of "Introduction" chapter for the real, much 
bigger Getting Started guide.

The goal is to demonstrate the power of Boost.Build.

It isn't necessary for a user to understand these examples completely.
A user should look at it and think: "Wow! It's much simpler and easier 
to maintain than makefiles or GUI-based MSVC IDE projects. I'd like to 
know more about how this works in real life and if there are any 
limitations or hidden disadvantages".

The sections should just show that complex real life situations are 
solved using a very little amount of clear, intuitively obvious, 
self-describing code.

The sections are for managers and their goal is to help them to evaluate 
pros and cons quickly and to sell the idea to use Boost.Build to the 
team and to the top management.

Andrey