ci: guard docs drift — mkdocs --strict as a PR check + link/anchor validation (#59)

Ports the docs CI drift guard: a parallel docs job running mkdocs --strict on
PRs, a validation block so broken links/anchors and orphaned pages fail the
build, and pinned docs deps.

Also fixes the two orphans the omitted_files check surfaced:
- adds the previously-orphaned index.md to the nav (as Overview);
- relocates docs/superpowers/{specs,plans} — superpowers spec/plan artifacts
  mistakenly written into the mkdocs docs_dir (and published live) — into a
  proper planning/changes/2026-06-29.01-python-3.11-3.12-support/ bundle, where
  the repo convention keeps them. Those two pages 404 off the docs site after
  deploy, which is correct: they were internal planning docs, not user docs.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: lesnik512

.github/workflows/_checks.yml

@@ -16,6 +16,14 @@ jobs:
       - run: uv python pin 3.13
       - run: just install lint-ci
 
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: extractions/setup-just@v4
+      - uses: astral-sh/setup-uv@v8.2.0
+      - run: just docs-build
+
   pytest:
     runs-on: ubuntu-latest
     strategy:

docs/requirements.txt

@@ -1,2 +1,2 @@
-mkdocs
-mkdocs-material
+mkdocs>=1.6,<2
+mkdocs-material>=9,<10

mkdocs.yml

@@ -4,6 +4,7 @@ repo_url: https://github.com/modern-python/faststream-redis-timers
 docs_dir: docs
 edit_uri: edit/main/docs/
 nav:
+  - Overview: index.md
   - Introduction:
       - Installation: introduction/installation.md
       - How it works: introduction/how-it-works.md
@@ -50,6 +51,12 @@ theme:
         icon: material/brightness-4
         name: Switch to system preference
 
+validation:
+  omitted_files: warn
+  absolute_links: warn
+  unrecognized_links: warn
+  anchors: warn
+
 markdown_extensions:
   - admonition
   - toc:

…06-29-python-3.11-3.12-support-design.md …29.01-python-3.11-3.12-support/design.mddocs/superpowers/specs/2026-06-29-python-3.11-3.12-support-design.md renamed to planning/changes/2026-06-29.01-python-3.11-3.12-support/design.md docs/superpowers/specs/2026-06-29-python-3.11-3.12-support-design.md renamed to planning/changes/2026-06-29.01-python-3.11-3.12-support/design.md

@@ -1,7 +1,8 @@
-# Support Python 3.11 and 3.12
+---
+summary: Lowered the supported-Python floor from 3.13 to 3.11 by backporting the PEP 695 type alias and typing.override via typing_extensions; widened the CI pytest matrix to 3.11/3.12.
+---
 
-**Date:** 2026-06-29
-**Status:** Approved design
+# Support Python 3.11 and 3.12
 
 ## Goal