From 464df2320a34961ca595d13f784911ae643682c5 Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 15:39:22 -0400
Subject: [PATCH 1/6] Try to fix readthedocs build

---
 .readthedocs.yml | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 03c98983..1392a7d1 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,15 +1,18 @@
 version: 2
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
     python: "3.12"
   jobs:
-    post_install:
+    pre_create_environment:
       - asdf plugin add uv
       - asdf install uv latest
       - asdf global uv latest
-      - uv sync --group docs
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs
     build:
       html:
         - uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT

From c0918a60a6c2ea50647fa9a7788df4ad1005b254 Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 16:01:57 -0400
Subject: [PATCH 2/6] Don't use frozen

---
 .readthedocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 1392a7d1..5faa11bb 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -12,7 +12,7 @@ build:
     create_environment:
       - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
     install:
-      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs
     build:
       html:
         - uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT

From 30d2cf1b402279e8ed1c486128499ebee20709a9 Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 16:07:43 -0400
Subject: [PATCH 3/6] Try to get past hardlink warning

---
 .readthedocs.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 5faa11bb..3d0e47b6 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -12,7 +12,7 @@ build:
     create_environment:
       - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
     install:
-      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs --link-mode=copy
     build:
       html:
         - uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT
@@ -25,3 +25,6 @@ sphinx:
 formats:
   - pdf
   - htmlzip
+
+sphinx:
+  fail_on_warning: false

From e8b2234022ac33fbbe49a9dacf89d0bce9e4c15c Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 16:08:59 -0400
Subject: [PATCH 4/6] Collapsing sections

---
 .readthedocs.yml | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 3d0e47b6..2cb696ae 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -21,10 +21,8 @@ build:
 
 sphinx:
   configuration: docs/conf.py
+  fail_on_warning: false
 
 formats:
   - pdf
   - htmlzip
-
-sphinx:
-  fail_on_warning: false

From f4545f9fd2d1e15443962f29b7b148e6518b413e Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 16:10:47 -0400
Subject: [PATCH 5/6] Set UV_PROJECT_ENVIRONMENT more often

---
 .readthedocs.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 2cb696ae..f3552e94 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -15,9 +15,9 @@ build:
       - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs --link-mode=copy
     build:
       html:
-        - uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT
+        - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT
       pdf:
-        - uv run -- sphinx-build -M latexpdf docs $READTHEDOCS_OUTPUT
+        - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv run -- sphinx-build -M latexpdf docs $READTHEDOCS_OUTPUT
 
 sphinx:
   configuration: docs/conf.py

From ec907da6f28a51bff9033091beb56e7b8add2d7e Mon Sep 17 00:00:00 2001
From: Julia Signell <jsignell@gmail.com>
Date: Fri, 19 Sep 2025 16:17:17 -0400
Subject: [PATCH 6/6] Is it possible we don't need the build lines?

---
 .readthedocs.yml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index f3552e94..57a8b182 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -13,11 +13,6 @@ build:
       - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
     install:
       - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs --link-mode=copy
-    build:
-      html:
-        - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT
-      pdf:
-        - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv run -- sphinx-build -M latexpdf docs $READTHEDOCS_OUTPUT
 
 sphinx:
   configuration: docs/conf.py