ENH: switching to JB2, tracking issue

[bsipocz]

Using this issue to track the work and issues for the JB2 transition. Code is in #119, but some of these items are upstreamed or can be addressed separately

• restructure TOC based on the google docs we have, see ENH: re-work subject headings #98 Make descriptive section headers #14