Currently there are a lot of warnings produce when building the sphinx documentation. These should all be cleaned up and then enable the [`sphinx.fail_on_warning`](https://docs.readthedocs.io/en/stable/config-file/v2.html#sphinx-fail-on-warning) option so that new warnings are not introduced.