diff --git a/.readthedocs.yml b/.readthedocs.yml
index 382fc67b..03560020 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -10,10 +10,17 @@ build:
     os: ubuntu-22.04
     tools:
         python: '3.11'
-    commands:
-        - asdf plugin add uv
-        - asdf install uv 0.1.44
-        - asdf global uv 0.1.44
-        - uv venv
-        - uv pip install .[docs]
-        - .venv/bin/python -m sphinx -W --keep-going -d _build/doctrees -D language=en -b html docs/source $READTHEDOCS_OUTPUT/html
+    jobs:
+        pre_create_environment:
+            - asdf plugin add uv
+            - asdf install uv 0.5.17
+            - asdf global uv 0.5.17
+        create_environment:
+            - uv venv $READTHEDOCS_VIRTUALENV_PATH
+        install:
+            - uv pip install .[docs] --no-cache --prefix $READTHEDOCS_VIRTUALENV_PATH
+
+sphinx:
+    builder: html
+    fail_on_warning: true
+    configuration: docs/source/conf.py