This PR address some (non-fatal) errors and warnings emitted by sphinx when building the documentation.