Review nitpicky warnings from Sphinx

**Describe the bug**

Sphinx raises lots of nit picking errors due to slight inaccuracies with cross-referencing different functions and classes. It would be good to clean these up.

Currently we don't fail on warnings when building the docs so small errors may creep through. Once this is cleaned up we might be able to tighten the raise error on warning flag (-W).
