From 0ea7ae0ae86b35b030825d4d240282fe4de6cc55 Mon Sep 17 00:00:00 2001
From: Matthias <matthias@crate.io>
Date: Mon, 28 Sep 2026 12:46:41 +0200
Subject: [PATCH] Pin version to dev release & add update conf.py

crate-docs becomes the root project of docs.cratedb.com, so it needs its
own theme config instead of inheriting the theme's own, plus the settings
for an unversioned project.

The theme is pinned to an exact pre-release. Every other project has a
loose version spec and pre-releases are excluded from those, so
0.51.0.dev0 reaches only this project and nothing else, the rest keep
building against the last stable theme while the migration is proven.

Restore crate-docs-theme>=0.42.0 once it ships as a final release.
---
 docs/conf.py          | 13 ++++++++++++-
 docs/requirements.txt |  7 ++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)
 mode change 100644 => 100755 docs/conf.py

diff --git a/docs/conf.py b/docs/conf.py
old mode 100644
new mode 100755
index a4d6cca..7421890
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1 +1,12 @@
-from crate.theme.rtd.conf.theme import *
+from crate.theme.rtd.conf.crate_docs import *
+
+# Re-configure sitemap generation URLs.
+# This is a project without versioning.
+sitemap_url_scheme = "{link}"
+
+# Disable version chooser.
+html_context.update({
+    "display_version": False,
+    "current_version": None,
+    "versions": [],
+})
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 5a1db45..d2d1abc 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,2 +1,7 @@
 sphinx>=3,<10
-crate-docs-theme>=0.42.0
+
+# TEMPORARY, for the docs.cratedb.com migration proof of concept.
+#
+# Restore `crate-docs-theme>=0.42.0` once the migration theme ships as a
+# final release.
+crate-docs-theme==0.51.0.dev0