Re: [boost] Boost documentation

From: Gennadiy Rozental (gennadiy.rozental_at_[hidden])
Date: 2007-07-02 21:46:43

"David Abrahams" <dave_at_[hidden]> wrote in message 
news:87d4zb7fm4.fsf_at_grogan.peloton...
>
> on Mon Jun 25 2007, "Gennadiy Rozental" <gennadiy.rozental-AT-thomson.com> 
> wrote:
>
>> "David Abrahams" <dave_at_[hidden]> wrote in message
>> news:87vedd16z5.fsf_at_grogan.peloton...
>>
>>>> 5. This is new *nonstandard* format any new developer will have to
>>>> learn. I don't believe we can afford yet another barrier for new
>>>> submitters.
>>>
>>> Unless they already know DocBook, DocBook represents a much higher
>>> barrier for most people getting started.
>>
>> I would guess that number of people familiar with DocBook would be much 
>> more
>> in comparison with QuickBook
>
> Granted.  I would guess that the number of people familiar with
> neither is much much more.  My point is that when you're starting from
> zero, QuickBook has a much shallower learning curve.
>
>> I don't believe boost should regulate what people use to develop docs. 
>> What
>> it should regulate is: what people need to use the docs.  IOW what we 
>> should
>> require is the presence of BoostBook file
>
> So you no longer object to BoostBook?  Before, you seemed to insist on
> pure DocBook.

I never did (at least never intended, I midght've mistyped docbook instead 
of boostbook in some contexts)

Gennadiy