Re: [jamboost] [BBv2 doc editorial] Tutorial

From: Andrey Melnikov (melnikov_at_[hidden])
Date: 2005-09-20 15:55:04

David Abrahams wrote:
> I have no comments on this section; just posting it here for the
> record and so that others can comment:

>>Chapter 23. Tutorial
>>
>>Table of Contents
>>
>>Hello, world
>>Properties
>> 
>> Build Requests and Target Requirements
>> Project Attributes
>> 
>>Project Hierarchies
>>Dependent Targets
>>Static and shared libaries
>>Conditions and alternatives
>>Prebuilt targets

The table of contents looks cryptic for a new user. The terms are used 
before they are defined:
- BB project
- Jam language
- build variants
- build targets

The examples don't demonstrate the key BB features and don't have a big 
practical usage for a newbie.

Look at my Getting Started Guide: http://tinyurl.com/bcgwf
It isn't perfect, but I think some ideas can be taken from there.

Andrey