For about a day now, docs.scipy.org has been down. This affects DM because our doc system uses intersphinx to help us link to API documentation for third-party packages we use, including
numpy. Since those docs sites aren’t available, Sphinx isn’t able to download their object inventories, and resolve the appropriate links in our docs.
I’m confident the docs.scipy.org problem will resolve itself soon, but here are two temporary mitigations to help you build and preview docs in the meantime.
First, you can try removing these intersphinx dependencies. At the end of your doc project’s
You can also loosen the strictness of Sphinx builds by removing the
-W arguments to the
sphinx-build command in your project’s
Please avoid merging these mitigations to master, though, especially for developer.lsst.io and pipelines.lsst.io. I think we can afford to wait for docs.scipy.org to come back.
Longer term, I think a proper mitigation, that will also increase our build performance, is to deploy a lightweight intersphinx cache microservice. The cache would gather intersphinx inventories and package them for our documentation builds. This would have dual benefits:
- Remove real-time dependence on third-party doc sites being up from our build toolchain.
- Rather than hitting multiple websites, the cache microservice can package all object inventories into a single download. This would let us efficiently handle object inventories for hundreds of LSST Sphinx documentation projects.