Pages

fix(release): rebuild action bundle with the version bump #14

	name: Pages

	on:
	push:
	branches: [main]
	pull_request:
	workflow_dispatch:

	# Validate the docs build on PRs (strict — warnings and broken nav links fail);
	# publish to GitHub Pages on pushes to main.
	# One-time: repo Settings → Pages → Source = "GitHub Actions".
	permissions:
	contents: read

	concurrency:
	group: pages
	cancel-in-progress: true

	jobs:
	build:
	runs-on: ubuntu-latest
	timeout-minutes: 10
	steps:
	- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
	- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
	with:
	node-version: '22'
	cache: npm
	- run: npm ci
	- name: Prose lint (stages docs itself)
	run: npm run lint:prose
	- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
	with:
	python-version: "3.12"
	- run: pip install mkdocs-material
	- name: Stage docs
	run: ./mkdocs-stage.sh
	- run: mkdocs build --strict
	- uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
	with:
	path: _site

	deploy:
	needs: build
	if: github.event_name != 'pull_request'
	runs-on: ubuntu-latest
	timeout-minutes: 5
	permissions:
	pages: write
	id-token: write
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	steps:
	- id: deployment
	uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

Navigation Menu