Fix some docs warnings
Description
There are various warnings raised in when building the documentation, one of which is an error in sphinx 2.0.0. This MR fixes most of them so that the docs build works in sphinx 2.0.0, leaving only an irrelevant warning and some things related to the autogenerated GRPC stub docstrings.
Changes proposed in this merge request:
- Fix some docs warnings