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

.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:

docs/superpowers/specs/2026-06-29-python-3.11-3.12-support-design.md → 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