Read these files in order:
- DIATAXIS.md - Determine the page type (tutorial, how-to, reference, explanation)
- CLAUDE.md - Follow the style guide (lead with code, no em dashes, tables over prose, etc.)
- Identify the page type using the compass in DIATAXIS.md
- Follow the rules for that type
- Apply CLAUDE.md style rules
- Use the matching page template from CLAUDE.md
- Writing a how-to guide that teaches basics (that's a tutorial)
- Adding explanation paragraphs inside reference docs (extract to a "What is X?" page)
- Making tutorials that offer choices ("you could also use..."). Tutorials follow one path.
- Including full parameter tables in how-to guides (link to reference instead)
- Using contrastive negation ("It's not X, it's Y"). State what it is directly.
- Using em dashes. Use periods or rewrite.