From 13628267cc0c7e845cee4146e19a5072ccaa3df5 Mon Sep 17 00:00:00 2001 From: Artur Shiriev Date: Sun, 5 Jul 2026 18:23:31 +0300 Subject: [PATCH] =?UTF-8?q?ci:=20guard=20docs=20drift=20=E2=80=94=20mkdocs?= =?UTF-8?q?=20--strict=20as=20a=20PR=20check=20+=20link/anchor=20validatio?= =?UTF-8?q?n?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a parallel docs job running mkdocs --strict on PRs (matching the deploy build), a validation block so broken internal links/anchors and orphaned pages fail the build, and upper-bound pins on the docs toolchain. Co-Authored-By: Claude Opus 4.8 (1M context) --- .github/workflows/_checks.yml | 8 ++++++++ docs/requirements.txt | 4 ++-- mkdocs.yml | 6 ++++++ 3 files changed, 16 insertions(+), 2 deletions(-) diff --git a/.github/workflows/_checks.yml b/.github/workflows/_checks.yml index 1444b27..0fd0b7f 100644 --- a/.github/workflows/_checks.yml +++ b/.github/workflows/_checks.yml @@ -16,6 +16,14 @@ jobs: - run: uv python pin 3.11 - 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: diff --git a/docs/requirements.txt b/docs/requirements.txt index 9a8a4ca..cba3dda 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,2 +1,2 @@ -mkdocs -mkdocs-material +mkdocs>=1.6,<2 +mkdocs-material>=9,<10 diff --git a/mkdocs.yml b/mkdocs.yml index da5f204..93782a5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -50,6 +50,12 @@ theme: extra_css: - css/brand.css +validation: + omitted_files: warn + absolute_links: warn + unrecognized_links: warn + anchors: warn + markdown_extensions: - toc: permalink: true