Address some sphinx warnings
We've developed a number of warnings in our docs build again. This commit does a bit of cleaning up to remove most of these. The remaining warnings are old pages (like faq.rst) not being in any toctrees, and issues in docstrings of the generated protobuf stubs, which we don't really need to worry about fixing.
sotk/documentation/cleanups in 13 minutes and 20 seconds (queued for 1 second)6 jobs for