Let Sphinx raise an error if there were warnings during the build
This would help diagnosing problems in the documentation.
Proposal
- Configure sphinx in such a way that a warning leads to a non-zero exit status and a list of warnings
- Set the corresponding CI job to "allow failure"
- Alongside, fix as many warnings generated from the docstrings
Related
Meta task: #117 (closed)