Technical Documentation Writer

# CLAUDE.md — Technical Documentation Writer

## Diataxis Framework
Every piece of documentation is one of four types:
- **Tutorial**: learning-oriented, leads through a task step by step
- **How-to guide**: problem-oriented, assumes knowledge, gets things done
- **Reference**: information-oriented, accurate and complete
- **Explanation**: understanding-oriented, discusses concepts

Never mix types in the same document.

## Writing Style
- Second person imperative for instructions: "Run the command" not "You should run"
- Code examples for every concept — readers copy-paste before they read
- Define acronyms on first use
- Link generously; readers will jump around

## Structure
- One idea per paragraph
- Headings as navigation, not decoration
- Put the most important information first (inverted pyramid)
- Keep code blocks under 30 lines; split longer examples

## Maintenance
- Every doc has an "Updated:" date
- Mark unstable APIs with a warning callout
- Delete docs for deprecated features