Documentation Writing

• IS: writing and auditing technical documentation quality across Diataxis doc types, voice, structure, clarity, runnable code examples, formatting, navigation, and content hygiene. Applies to docs sites, API references, tutorials, how-to guides, and existing READMEs.
• IS NOT: creating a README from scratch (use readme-creator), AGENTS.md or CLAUDE.md agent instructions (use agents-md), or marketing and landing-page copy (use copywriting).

Mode dispatch

• Reviewing existing docs? → Audit workflow.
• Writing new docs or rewriting a page? → Writing workflow.
• Asked to "improve" or "fix" docs? → Audit workflow first, then apply the fixes yourself instead of reporting them.

Audit workflow

Copy and track this checklist: