Documentation

Structure Hierarchy

• README: what it is, how to install, quick example — 5 minutes to first success
• Getting Started: guided tutorial for beginners — one complete workflow
• Guides: task-oriented ("How to X") — goal-focused, not feature-focused
• Reference: exhaustive API/CLI docs — complete but not for learning
• Troubleshooting: common errors with solutions — search-optimized

README Essentials

1. One-sentence description — what problem it solves
2. Installation — copy-paste command that works
3. Quick start — minimal example that actually runs
4. Link to full docs — don't cram everything in README

Missing any of these = users bounce before trying.

Code Examples