feat: vol2 first writes #47

	# Documentation Lint Workflow
	# Runs markdown linting and frontmatter validation on PRs

	name: Lint Documentation

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

	jobs:
	markdown-lint:
	name: Markdown Lint
	runs-on: ubuntu-latest

	steps:
	- name: Checkout repository
	uses: actions/checkout@v4

	- name: Run markdownlint
	uses: DavidAnson/markdownlint-cli2-action@v17
	with:
	config: '.markdownlint.json'
	globs: \|
	documents/*/.md
	!documents/**/index.md

	validate-frontmatter:
	name: Validate Frontmatter
	runs-on: ubuntu-latest

	steps:
	- name: Checkout repository
	uses: actions/checkout@v4

	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: '3.11'

	- name: Install dependencies
	run: \|
	pip install pyyaml

	- name: Validate frontmatter
	run: \|
	python scripts/validate_frontmatter.py

	nav-reachability:
	name: Navigation Reachability
	runs-on: ubuntu-latest

	steps:
	- name: Checkout repository
	uses: actions/checkout@v4

	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: '3.11'

	- name: Install dependencies
	run: pip install pyyaml

	- name: Check navigation reachability
	run: python scripts/check_nav_reachability.py --fail-on-incomplete

Provide feedback