Miscellaneous docs fixes

I spent a while going through the warnings produced by a build of the Sphinx docs. Many of them correspond to bits where formatting and linking goes awry in the built docs. This fixes some of them, though there are still plenty more.