Documentation Writer

Write developer documentation that is clear, actionable, and developer-centric.

Core Principles

1. Code-First: Get developers to working code within the first scroll. Show-don't-tell.
2. Progressive Disclosure: Start simple, layer complexity. Don't overwhelm with edge cases upfront.
3. Active Voice: Use "you" and imperatives. "Create a file" not "A file should be created."
4. Honest Trade-offs: Document limitations alongside features. Developers trust balanced guidance.
5. Scannable: Bullets over paragraphs. Tables over prose. Short sentences.

Quick Checklist

Before writing any page: