Pushed up a proposed doc reformatting as a separate commit.  Can squash if it seems like a good change, or revert otherwise.