📄 docs: publish llms.txt from the docs build (#522)

Author: gaborbernat

docs/conf.py

@@ -3,6 +3,7 @@
 
 from __future__ import annotations
 
+import os
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -15,6 +16,7 @@
 release = __version__
 version = release
 extensions = [
+    "sphinx_llm.txt",
     "sphinx.ext.autodoc",
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.extlinks",
@@ -58,3 +60,5 @@
 towncrier_draft_working_directory = Path(__file__).parent.parent
 # Towncrier news fragments are rST snippets folded into changelog.rst at release; they are not standalone pages.
 exclude_patterns = ["changelog/*"]
+
+markdown_http_base = os.environ.get("READTHEDOCS_CANONICAL_URL", "")

pyproject.toml

@@ -80,6 +80,7 @@ docs = [
   "sphinx-autodoc-typehints>=3.9.2",
   "sphinx-copybutton>=0.5.2",
   "sphinx-design>=0.7",
+  "sphinx-llm>=0.4.1",
   "sphinx-sitemap>=2.9",
   "sphinxcontrib-mermaid>=2",
   "sphinxcontrib-towncrier>=0.5.0a0",