doc: Fix warnings when documentation is built locally

[cadenmyers13]

Problem

There are a lot of format warnings when the documentation is built locally. To reproduces those warnings run this from the top level dir:

cd doc && make html && open build/html/index.html

Proposed solution

Go through and address all these warning. This might be a bit tedious because it must be done manually.