Skip to content

Fix docs build: pin warp intersphinx to /latest/#5543

Closed
hujc7 wants to merge 1 commit intoisaac-sim:developfrom
hujc7:jichuanh/fix-warp-intersphinx
Closed

Fix docs build: pin warp intersphinx to /latest/#5543
hujc7 wants to merge 1 commit intoisaac-sim:developfrom
hujc7:jichuanh/fix-warp-intersphinx

Conversation

@hujc7
Copy link
Copy Markdown
Collaborator

@hujc7 hujc7 commented May 8, 2026

Summary

https://nvidia.github.io/warp/objects.inv now returns 404 — the Warp docs published objects.inv only at versioned subpaths (/latest/, /stable/, etc.). With Sphinx's warnings treated as errors, the broken intersphinx fetch fails the docs build on every PR (#5536, #5538, #5540-#5542 all failing on Build 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

  • Verified https://nvidia.github.io/warp/latest/objects.inv returns 200
  • CI Build Latest Docs job passes on this PR (was failing on develop)

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).
@github-actions github-actions Bot added bug Something isn't working documentation Improvements or additions to documentation isaac-lab Related to Isaac Lab team labels May 8, 2026
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 8, 2026

Greptile Summary

Fixes the docs build by pinning the Warp intersphinx mapping from the broken root URL (https://nvidia.github.io/warp/) to /latest/, which is where objects.inv now lives. A changelog fragment is also added.

  • docs/conf.py: changes the warp entry in intersphinx_mapping to https://nvidia.github.io/warp/latest/ and adds a comment following the same pattern used for the torch pin.
  • source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst: new changelog fragment describing the fix.

Confidence Score: 4/5

Safe 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

Filename Overview
docs/conf.py Pins warp intersphinx URL from the broken root path to /latest/, with an explanatory comment consistent with the existing torch pin pattern.
source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst New changelog fragment documenting the warp intersphinx fix; format and content are correct.

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"]
Loading

Reviews (1): Last reviewed commit: "Fix docs build: pin warp intersphinx to ..." | Re-trigger Greptile

@hujc7
Copy link
Copy Markdown
Collaborator Author

hujc7 commented May 8, 2026

Folded into #5538 — both unblock develop CI in one PR.

@hujc7 hujc7 closed this May 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation isaac-lab Related to Isaac Lab team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant