I think I've fixed all the problems I can fix in the new style docs <https://grafikrobot.github.io/b2doc/> for b2:
* Fully updated with develop docs.
* Works offline as well as it does online.
* All the cross-links work.
* Marked up all the code to be syntax colored.
Big question is now.. Go with this or no? Note, that this would be a change for some future release not the current Boost 1.67 cycle.