Re: [boost] Boost documentation

From: David Abrahams (dave_at_[hidden])
Date: 2007-07-01 21:34:43

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.

-- 
Dave Abrahams
Boost Consulting
http://www.boost-consulting.com
The Astoria Seminar ==> http://www.astoriaseminar.com