Resolve warnings emitted when building the docs

[maximlt]

Looking at the logs on the CI following the last docs build, we can see the build emits hundreds of warnings.

build succeeded, 335 warnings.