The current sphinx-build output contains a lot of warnings; some of them can be disregarded but some of them can be major, like disabling the autogenerated docs from the code altogether (see #346). Ideally we should cleanup the warnings and then build with -W so that new warnings fail the build. Cleaning up the warnings isn't as straightforward as we might like because some of them are from the various sphinx plugins interacting badly with Pydantic.
The current sphinx-build output contains a lot of warnings; some of them can be disregarded but some of them can be major, like disabling the autogenerated docs from the code altogether (see #346). Ideally we should cleanup the warnings and then build with
-W
so that new warnings fail the build. Cleaning up the warnings isn't as straightforward as we might like because some of them are from the various sphinx plugins interacting badly with Pydantic.