Write Documentation

Documentation that is scannable, consistent, and actionable for AI agents.

Structure

• Max 150 lines per file, one concept per file
• Start with description: in YAML frontmatter
• Add TL;DR section at top with most-needed info

Content

• No duplicates (define once, link elsewhere)
• Use tables for structured data (parameters, config)
• Concrete examples for everything (copy-pasteable)
• Link to real code as templates

Naming

Tips

• Use consistent terms (one term per concept)
• Group by task ("How to add X") not system ("X overview")
• Include troubleshooting for common errors