write-docs

Overview

Write clear, progressive documentation for this repository using the existing Starlight + MDX docs setup. Favor stepwise examples, explicit usefulness, and consistent tone.

Workflow

1. Locate the target doc or create a new MDX file under www/src/content/docs/.
2. Follow the style reference in references/docs-style.md.
3. Start each feature or API section with: what it does, why it is useful, then an example.
4. Build examples incrementally (naive first, then improvements and features).
5. Use Starlight code line highlighting (ins, del, {n-m}) to emphasize changes while keeping full context.
6. Keep guide content and API reference content clearly separated by headings or separate docs.

House style essentials

• Use second-person voice and consistent terminology.
• Avoid emojis, slang, or playful narration.
• Prefer short, direct sentences and descriptive headings.

References

• Read references/docs-style.md for the full style guide and code highlighting examples.