Fix warnings when building the docs

It may be nice to make builds fail if new documentation generates warnings, to
avoid these sorts of problems slipping in in the future.
Merge pull request #1832 from kevinburke/docs-warnings

Fix warnings when building the docs