On Sat, Jan 20, 2018 at 10:37 AM, Robert Ramey via Boost-build <boost-build@lists.boost.org> 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?

Yes.

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.

Yes.

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 - http://robot-dreams.net