From 5ae0e51f65e1ffc8ffd7911f92dca3635a55b409 Mon Sep 17 00:00:00 2001
From: James Estevez <jestevez@salesforce.com>
Date: Fri, 15 Nov 2024 13:33:27 -0800
Subject: [PATCH] Fix readthedocs configuration (#3845)

- Rename readthedocs.yml to .readthedocs.yml,
- update to Ubuntu 22.04 and Python 3.12,
- add uv setup and Sphinx build commands.
---
 readthedocs.yml => .readthedocs.yml | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)
 rename readthedocs.yml => .readthedocs.yml (59%)

diff --git a/readthedocs.yml b/.readthedocs.yml
similarity index 59%
rename from readthedocs.yml
rename to .readthedocs.yml
index 041aaf738f..4f0f038758 100644
--- a/readthedocs.yml
+++ b/.readthedocs.yml
@@ -7,9 +7,15 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-    os: ubuntu-20.04
+    os: ubuntu-22.04
     tools:
-        python: "3.9"
+        python: "3.12"
+    commands:
+        - asdf plugin add uv
+        - asdf install uv latest
+        - asdf global uv latest
+        - uv sync --only-group docs --frozen
+        - uv run -m sphinx -T -b html -d docs/_build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -19,8 +25,3 @@ sphinx:
 formats:
     - pdf
     - epub
-
-# Optionally declare the Python requirements required to build your docs
-python:
-    install:
-        - requirements: requirements_dev.txt