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.
There are only some minor items missing in the docs (examples only AFAIK). The process for transferring the docs turned out to involve using quickbook to generate boostbook for the non boostbook parts. And using pandoc to mass translate from boostbook (assuming it was close enough to docbook) to asciidoctor. THen it was a matter of going through all the docs and fixing up any translation errors.
This is just an initial translation.. And will be followed in the future with more automation, style, additions, rewrites, etc changes. Assuming key people are okay with this new set of docs.
--