Re: [BBv2 docs editorial] How to use this document

From: David Abrahams (dave_at_[hidden])
Date: 2005-09-21 09:28:12

Vladimir Prus <ghost_at_[hidden]> writes:

> On Wednesday 21 September 2005 02:29, Andrey Melnikov wrote:
>> David Abrahams wrote:
>> > Andrey Melnikov <melnikov_at_[hidden]> writes:
>> >>David Abrahams wrote:
>> >>>>Chapter 21. How to use this document
>> >>>>
>> >>>>If you've just found out about Boost.Build V2 and want to know if it
>> >>>>will work for you, start with Chapter 23, Tutorial.
>> >>
>> >>IMO the Tutorial doesn't answer this question. I'd like to see something
>> >>like "Key advantages" section of
>> >>http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost.Buil
>> >>d_V2/GettingStarted here.
>> >
>> > Wow that page is great! Can you make the edits you're suggesting,
>> > please?
>>
>> 1) I need someone to fix my English grammar
>
> I can do the first round (it's easy to find errors in other's writing than 
> avoid same errors myself) and Dave can take a look then.

Agreed; thanks for volunteering me ;-)

>> 2) The page isn't a tutorial (see my answer in "tutorial" thread)
>
> We can dedicate a separate section.
>
>> 3) I'd like to restructure it again as I now see some disadvantages and
>> lack of conceptual integrity there.
>
> Ok, when you're done, let me know. Patch to docbook sources will be great, but 
> if you don't know docbook, just edit the Wiki, and I'll take it from there.

Agreed. But learn BoostBook; it isn't hard and it will save all of us
(even you) considerable time to do so. 

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com