Documentation

The documentation for this project is available in the docs/ directory. It uses GitHub-flavored markdown with Astro Starlight for rendering and follows the Diátaxis framework for systematic documentation.

Diátaxis Framework

Documentation must be organized into four distinct types, each serving a specific purpose:

1. Tutorials (Learning-Oriented)

Purpose: Guide beginners through achieving a specific outcome to build confidence.

Start with what the user will build or achieve
Provide a clear, step-by-step path from start to finish
Include concrete examples and working code
Assume minimal prior knowledge
Focus on the happy path (avoid edge cases and alternatives)
End with a working result the user can see and use
Use imperative mood: "Create a file", "Run the command"