Skip to content

Commit 714d0fd

Browse files
lesnik512claude
andauthored
ci: guard docs drift — mkdocs --strict as a PR check + link/anchor validation (#48)
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 0572185 commit 714d0fd

3 files changed

Lines changed: 16 additions & 2 deletions

File tree

‎.github/workflows/_checks.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,14 @@ jobs:
1616
- run: uv python pin 3.11
1717
- run: just install lint-ci
1818

19+
docs:
20+
runs-on: ubuntu-latest
21+
steps:
22+
- uses: actions/checkout@v6
23+
- uses: extractions/setup-just@v4
24+
- uses: astral-sh/setup-uv@v8.2.0
25+
- run: just docs-build
26+
1927
pytest:
2028
runs-on: ubuntu-latest
2129
strategy:

‎docs/requirements.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
mkdocs
2-
mkdocs-material
1+
mkdocs>=1.6,<2
2+
mkdocs-material>=9,<10

‎mkdocs.yml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,12 @@ theme:
5252
extra_css:
5353
- css/brand.css
5454

55+
validation:
56+
omitted_files: warn
57+
absolute_links: warn
58+
unrecognized_links: warn
59+
anchors: warn
60+
5561
markdown_extensions:
5662
- toc:
5763
permalink: true

0 commit comments

Comments
 (0)