Skip to content

v0.5.0 - Pages, onboarding, and guided navigation

Release date: 2026-03-01

Executive summary

This release turns the docs collection into a live GitHub Pages study site with clear onboarding, better route discovery, and guided next-step navigation.

Adds

  • GitHub Pages deployment workflow with MkDocs Material.
  • Site home and onboarding pages:
  • docs/index.md
  • docs/how-to-use-this-site.md
  • docs/contributing.md
  • docs/template-library.md
  • Automatic "Next step" and "Related pages" footer links in site pages.
  • README badges for docs site and pages deployment status.

Changes

  • Expanded nav structure in mkdocs.yml to map core docs by learning goal.
  • Improved first-time learner path from README into site onboarding.
  • Expanded footer coverage across onboarding, resources, and drills.

Removals

  • None.

Fixes

  • Reduced orphan-page risk by adding clearer cross-page navigation.
  • Improved discoverability for new users entering from the main page.

Validation

  • make docs-check
  • uvx --with mkdocs-material mkdocs build --strict