Build, Test, and Development Commands

Prefer Make targets from the repo root:

  • make install — install Python dependencies (uv sync).
  • make serve — local dev server at http://127.0.0.1:8011 using mkdocs.local.yml.
  • make serve-dirty — faster reloads when editing lots of content.
  • make build — strict local build, then sitemap post-process (scripts/postprocess_sitemap.py).
  • make build-prod — strict build with full mkdocs.yml.
  • make check — validation gate (same strict build path as routine verification).
  • make new-article NAME="My Title" — scaffold content/articles/my-title/index.md.