Repository navigation

Docs

chore(deps): bump the npm-minor-and-patch group across 1 directory with 8 updates #37

	name: Docs

	on:
	push:
	branches: [main]
	paths:
	- 'docs/**'
	- 'scripts/sync-docs-site.mjs'
	- 'package.json'
	- 'package-lock.json'
	- '.github/workflows/docs.yml'
	pull_request:
	paths:
	- 'docs/**'
	- 'scripts/sync-docs-site.mjs'
	- 'package.json'
	- 'package-lock.json'
	- '.github/workflows/docs.yml'

	permissions:
	contents: read

	concurrency:
	group: docs-${{ github.ref }}
	cancel-in-progress: true

	jobs:
	build:
	name: Build docs site
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
	with:
	persist-credentials: false
	- uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
	with:
	node-version: 22.22.2
	cache: npm
	registry-url: https://registry.npmjs.org/
	- run: npm ci
	# Fails on dead links — this is the docs quality gate.
	- run: npm run docs:build
	- if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
	uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
	- if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
	uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
	with:
	path: docs/.vitepress/dist

	deploy:
	name: Deploy to GitHub Pages
	if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
	needs: build
	permissions:
	pages: write
	id-token: write
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	runs-on: ubuntu-latest
	steps:
	- id: deployment
	uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0