diff --git a/.readthedocs.yml b/.readthedocs.yml
index ccf156f3..e98dc7b5 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -8,15 +8,6 @@ build:
   tools:
     python: "3.10"
 
-  # install mujoco warp to generate api documentation
-  jobs:
-    post_install:
-      - pip install uv
-      - mkdir -p /tmp/mujoco_warp
-      - cp -r mjx/mujoco/mjx/third_party/mujoco_warp/ /tmp/mujoco_warp/
-      - mv /tmp/mujoco_warp/mujoco_warp/pyproject.toml /tmp/mujoco_warp/
-      - uv pip install -e /tmp/mujoco_warp
-
 sphinx:
   builder: html
   configuration: doc/conf.py
@@ -24,4 +15,8 @@ sphinx:
 
 python:
   install:
-    - requirements: doc/requirements.txt
+    - method: pip
+      requirements: ./doc/requirements.txt
+
+    - method: uv
+      path: ./mjx/mujoco/mjx/third_party/mujoco_warp