From 92b235e42566b9f5e07a4bc9dda5d83e2ff39105 Mon Sep 17 00:00:00 2001
From: jichuanh <jichuanh@nvidia.com>
Date: Fri, 8 May 2026 05:03:01 +0000
Subject: [PATCH] Fix docs build: pin warp intersphinx to /latest/

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).
---
 docs/conf.py                                                 | 3 ++-
 .../isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst   | 5 +++++
 2 files changed, 7 insertions(+), 1 deletion(-)
 create mode 100644 source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst

diff --git a/docs/conf.py b/docs/conf.py
index 792ee6eeecbc..1cccab41076c 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -140,7 +140,8 @@
     "torch": ("https://docs.pytorch.org/docs/2.11/", None),
     "isaacsim": ("https://docs.isaacsim.omniverse.nvidia.com/6.0.0/py/", None),
     "gymnasium": ("https://gymnasium.farama.org/", None),
-    "warp": ("https://nvidia.github.io/warp/", None),
+    # NOTE: pinned to /latest/ because /objects.inv at the root currently 404s
+    "warp": ("https://nvidia.github.io/warp/latest/", None),
     "omniverse": ("https://docs.omniverse.nvidia.com/dev-guide/latest", None),
 }
 
diff --git a/source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst b/source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst
new file mode 100644
index 000000000000..ac68de751aa4
--- /dev/null
+++ b/source/isaaclab/changelog.d/jichuanh-fix-warp-intersphinx.rst
@@ -0,0 +1,5 @@
+Fixed
+^^^^^
+
+* Fixed Sphinx docs build failing due to ``https://nvidia.github.io/warp/objects.inv`` returning 404.
+  Pinned the ``warp`` intersphinx mapping to ``/latest/``, which is where the inventory now lives.