diff --git a/.readthedocs.yml b/.readthedocs.yml
index bd648615c5..777f7f19a8 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -15,18 +15,17 @@ build:
   jobs:
     # Use uv to speed up the build
     # https://docs.readthedocs.io/en/stable/build-customization.html#install-dependencies-with-uv
-    post_create_environment:
+    pre_create_environment:
     - asdf plugin add uv
-    - asdf install uv 0.2.9
-    - asdf global uv 0.2.9
-    post_install:
-    - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH uv pip install .[docs,tests,rest,atomic_tools]
-
-# Let the build fail if there are any warnings
-sphinx:
-  builder: html
-  configuration: docs/source/conf.py
-  fail_on_warning: true
+    - asdf install uv 0.5.17
+    - asdf global uv 0.5.17
+    create_environment:
+    - uv venv
+    install:
+    - uv sync --extra docs --extra tests --extra rest --extra atomic_tools
+    build:
+      html:
+      - uv run sphinx-build -T -W --keep-going -b html -d _build/doctrees -D language=en docs/source $READTHEDOCS_OUTPUT/html
 
 search:
   ranking: