Fix Sphinx warnings when creating documentation

We have accumulated a bunch of Sphinx warnings which show outright bugs or things we should improve. We should fix the warnings where possible.