Boost logo

Boost-Build :

Subject: Re: [Boost-build] New doc format.
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2018-01-20 17:03:34

On Sat, Jan 20, 2018 at 10:37 AM, Robert Ramey via Boost-build <
boost-build_at_[hidden]> wrote:

> On 1/14/18 2:35 PM, Rene Rivera via Boost-build wrote:
>> After asking about documentation tools some months back I ended up doing
>> a full "trial" with asciidoctor to see how it would work out for the new B2
>> documentation. I realize that others had ideas as to what might be a better
>> tool. But after looking into some others I decided asciidoctor was the
>> least effort to attempt to change to. And that the features, with regards
>> to B2, where sufficiently equivalent with the other top contenders.
> Is this about new b2 documentation or new format/way of presentation?


I'm very happy with the boost book approach.

What aspect(s) of it are you happy with?

I've always been of the the view that B2 documenation content would benefit
> from some investment of effort.


Doing both of the above in one shot seems a bad idea to me.

Not doing both at the same time. First step in this is putting the existing
documentation in a format and arrangement that facilitates the editing,
creation, and presentation of that documentation to as many audiences as
possible. Part of this is also looking forward at a time when B2 will not
be primarily advertised as a member of Boost.

-- Rene Rivera
-- Grafik - Don't Assume Anything
-- Robot Dreams -

Boost-Build list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at