Fix docs build: pin warp intersphinx to /latest/#5543
Fix docs build: pin warp intersphinx to /latest/#5543hujc7 wants to merge 1 commit intoisaac-sim:developfrom
Conversation
https://nvidia.github.io/warp/objects.inv now returns 404; the inventory moved under /latest/ (and /stable/). With warnings treated as errors, the broken intersphinx fetch fails the docs build on every PR. Repro: any recent CI run on develop, e.g. https://github.com/isaac-sim/IsaacLab/actions/runs/25533637651/job/74955918336 WARNING: failed to reach any of the inventories with the following issues: intersphinx inventory 'https://nvidia.github.io/warp/objects.inv' not fetchable due to 404 Client Error: Not Found build finished with problems, 1 warning (with warnings treated as errors).
Greptile SummaryFixes the docs build by pinning the Warp intersphinx mapping from the broken root URL (
Confidence Score: 4/5Safe to merge — the one-line URL fix directly unblocks the failing docs build with no risk of regressions elsewhere. The change is minimal and targeted. Pinning to /latest/ means the intersphinx inventory will silently follow whatever Warp publishes as latest, so if Warp makes a breaking rename in a future release, cross-reference links could break again without any change to this repo. Using /stable/ instead would be slightly more conservative, but /latest/ is the pattern already established by the omniverse entry in this file and the PR author has verified the URL returns 200. No files require special attention; the only substantive change is the single URL string in docs/conf.py. Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Sphinx docs build starts] --> B[intersphinx fetches warp objects.inv]
B -- Before PR --> C["GET https://nvidia.github.io/warp/objects.inv"]
C --> D["404 Not Found"]
D --> E["warnings-as-errors → build FAILS"]
B -- After PR --> F["GET https://nvidia.github.io/warp/latest/objects.inv"]
F --> G["200 OK"]
G --> H["Cross-reference links resolved → build PASSES"]
Reviews (1): Last reviewed commit: "Fix docs build: pin warp intersphinx to ..." | Re-trigger Greptile |
|
Folded into #5538 — both unblock develop CI in one PR. |
Summary
https://nvidia.github.io/warp/objects.invnow returns 404 — the Warp docs publishedobjects.invonly at versioned subpaths (/latest/,/stable/, etc.). With Sphinx'swarnings treated as errors, the broken intersphinx fetch fails the docs build on every PR (#5536, #5538, #5540-#5542 all failing onBuild Latest Docs).Pinning to
/latest/matches what other intersphinx targets in this file already do (see the existing PyTorch/docs/2.11/pin, also added to work around a /stable/ 404).Test plan
https://nvidia.github.io/warp/latest/objects.invreturns 200Build Latest Docsjob passes on this PR (was failing on develop)