Strict/nitpicky sphinx settings break our rpm builds
This is a post-mortem report of the task of diagnosing and fixing broken builds.
In #950, we turned on strict docs builds, but this ended up breaking our builds.
The problem was that there's no internet access inside the mock buildroot, so when sphinx went to download the intersphinx inventory files it would fail. Normally this triggers a warning, but enabling strict mode promotes all build warnings to errors. It's worth pointing out that the intersphinx downloads have always been failing during RPM build, the only thing new was our strictness.
Strict building is good; at the moment work is ongoing in #950 to modify our docs build process to hopefully (among many other goals) allow us to once again do strict builds with sphinx without breaking the build.
Updated by semyers over 6 years ago
All of these PRs are associated with #950, but I'm including them here as links since they're what we needed to fix this specific issue.