Documentation Fixes

Fixes for all the non-docstring-related warnings/errors displayed when building the documentation.

Those fixes should help people working on improving docstrings see the issues more clearly.