This PR improves the documentation by resolving a number of warnings raised during sphinx-build.
sphinx-build