.PHONY: help docs-index docs-build docs-serve docs-check slides

help:
	@echo "Targets:"
	@echo "  docs-index   Regenerate docs/hardware/index.md from per-host frontmatter"
	@echo "  docs-build   Build the static MkDocs site into ./site (strict)"
	@echo "  docs-serve   Run a live-reload local preview server"
	@echo "  docs-check   Drift-check: regenerate index, fail if it differs from the committed copy"
	@echo "  slides       Run build-slides.sh (Marp slides)"

docs-index:
	python3 scripts/gen_overview.py --category hardware

docs-build:
	mkdocs build --strict

docs-serve:
	mkdocs serve

docs-check:
	python3 scripts/gen_overview.py --category hardware
	git diff --exit-code docs/hardware/index.md

slides:
	./build-slides.sh
