From 542a41c6f4937fe98f390d32f9888b7d36ae669f Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 11 Dec 2025 09:37:02 +0000
Subject: [PATCH 1/6] sphinx-llms-txt => sphinx-llm

---
 doc/conf.py | 2 +-
 pixi.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index 1de49fc2721..0e5b2906fa5 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -63,7 +63,7 @@
     "sphinx_design",
     "sphinx_inline_tabs",
     "sphinx_remove_toctrees",
-    "sphinx_llms_txt",
+    "sphinx_llm.txt",
 ]
 
 
diff --git a/pixi.toml b/pixi.toml
index f7f80674d22..2830eb5283a 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -231,7 +231,7 @@ sphinx-autosummary-accessors = "*"
 sphinx-copybutton = "*"
 sphinx-design = "*"
 sphinx-inline-tabs = "*"
-sphinx-llms-txt = "*"
+sphinx-llm = "*"
 sphinx = ">=6,<8"
 sphinxcontrib-mermaid = "*"
 sphinxcontrib-srclinks = "*"

From 20e319aacd7c4a9a6fedc0bf81aac35ab43f7493 Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 11 Dec 2025 10:43:25 +0000
Subject: [PATCH 2/6] Nudge build again


From b0fd18bd17472eb3bc212bd7ddcbe95a5c2df64f Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 11 Dec 2025 12:05:43 +0000
Subject: [PATCH 3/6] Switch to sequential build

---
 doc/conf.py | 3 +++
 pixi.toml   | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 0e5b2906fa5..c02af5d70e0 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -178,6 +178,9 @@
 # mermaid config
 mermaid_version = "11.6.0"
 
+# sphinx-llm config
+llms_txt_build_parallel = False
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates", sphinx_autosummary_accessors.templates_path]
 
diff --git a/pixi.toml b/pixi.toml
index 2830eb5283a..6c5fd6faa02 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -231,7 +231,6 @@ sphinx-autosummary-accessors = "*"
 sphinx-copybutton = "*"
 sphinx-design = "*"
 sphinx-inline-tabs = "*"
-sphinx-llm = "*"
 sphinx = ">=6,<8"
 sphinxcontrib-mermaid = "*"
 sphinxcontrib-srclinks = "*"
@@ -241,6 +240,7 @@ sphinxext-rediraffe = "*"
 
 [feature.doc.pypi-dependencies]
 cfgrib = "*" # pypi dep because of https://github.com/prefix-dev/pixi/issues/3032#issuecomment-3302638043
+sphinx-llm = ">=0.2.1"
 
 [feature.doc.tasks]
 doc = { cmd = "make html", cwd = "doc" }

From d5855160267da7116665cd0d64c9c40f50c90761 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:08:11 +0000
Subject: [PATCH 4/6] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 pixi.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pixi.toml b/pixi.toml
index 6c5fd6faa02..9ae55d85838 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -239,7 +239,7 @@ sphinxext-opengraph = "*"
 sphinxext-rediraffe = "*"
 
 [feature.doc.pypi-dependencies]
-cfgrib = "*" # pypi dep because of https://github.com/prefix-dev/pixi/issues/3032#issuecomment-3302638043
+cfgrib = "*"           # pypi dep because of https://github.com/prefix-dev/pixi/issues/3032#issuecomment-3302638043
 sphinx-llm = ">=0.2.1"
 
 [feature.doc.tasks]

From 35bc87942738d2e527ff3ded79ce6827be07565e Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 11 Dec 2025 13:42:06 +0000
Subject: [PATCH 5/6] Move sphinx-llm dependency back to conda-forge version

---
 pixi.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pixi.toml b/pixi.toml
index 6c5fd6faa02..5617448b610 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -231,6 +231,7 @@ sphinx-autosummary-accessors = "*"
 sphinx-copybutton = "*"
 sphinx-design = "*"
 sphinx-inline-tabs = "*"
+sphinx-llm = ">=0.2.1"
 sphinx = ">=6,<8"
 sphinxcontrib-mermaid = "*"
 sphinxcontrib-srclinks = "*"
@@ -240,7 +241,6 @@ sphinxext-rediraffe = "*"
 
 [feature.doc.pypi-dependencies]
 cfgrib = "*" # pypi dep because of https://github.com/prefix-dev/pixi/issues/3032#issuecomment-3302638043
-sphinx-llm = ">=0.2.1"
 
 [feature.doc.tasks]
 doc = { cmd = "make html", cwd = "doc" }

From fe7bf9a629cf308e29df73b3093abf8194e2ef29 Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 11 Dec 2025 13:46:02 +0000
Subject: [PATCH 6/6] Add more context to config options

---
 doc/conf.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/conf.py b/doc/conf.py
index c02af5d70e0..40c64bd0e74 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -179,6 +179,8 @@
 mermaid_version = "11.6.0"
 
 # sphinx-llm config
+# Some jupyter-execute cells are not thread-safe, so we need to build sequentially.
+# See https://github.com/pydata/xarray/pull/11003#issuecomment-3641648868
 llms_txt_build_parallel = False
 
 # Add any paths that contain templates here, relative to this directory.