From 131561b9be5a137d876bf57da4e4f367780510c1 Mon Sep 17 00:00:00 2001
From: Nathan Schepers <3958483+nathanschepers@users.noreply.github.com>
Date: Fri, 31 Jul 2026 19:22:34 +0300
Subject: [PATCH] pyproject: state the closed-select ruff policy; SETUP: verify
 the RTD webhook and a second build

---
 template/SETUP.md.jinja       | 4 ++++
 template/pyproject.toml.jinja | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/template/SETUP.md.jinja b/template/SETUP.md.jinja
index ea08b82..a0a5fad 100644
--- a/template/SETUP.md.jinja
+++ b/template/SETUP.md.jinja
@@ -71,6 +71,10 @@ Import at <https://app.readthedocs.org/> (it auto-detects `.readthedocs.yaml`).
 doesn't appear in the list, use **Import Manually** with the repo URL — that bypasses the stale
 discovery list. Add the incoming-webhook URL + secret under the repo's Settings → Webhooks
 (events: push, create, delete) so docs rebuild on push and tags become versions.
+
+Verify the webhook exists — `gh api repos/<org>/<name>/hooks` lists a readthedocs.org URL — and
+that a subsequent push starts a second RTD build. The import's initial build runs without the
+webhook, so first-build-green does not confirm the connection.
 [% if publish_to_pypi %]
 After the first publish, the PyPI Documentation URL fills in automatically from `[project.urls]`.
 [% endif %]
diff --git a/template/pyproject.toml.jinja b/template/pyproject.toml.jinja
index f467b44..091d93b 100644
--- a/template/pyproject.toml.jinja
+++ b/template/pyproject.toml.jinja
@@ -73,6 +73,8 @@ src = ["src", "tests"]
 [% if web_service and database != "none" %]extend-exclude = ["alembic"]
 [% endif %]
 
+# Closed list via `select`, never `extend-select`: a ruff upgrade must not change
+# which rules run. Widen the list deliberately, per project.
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B", "D"]