Docs structure (maintainer)¶
Every page should answer:
- What is this for?
- Who is it for?
- What can the reader do with it?
Recommended page skeleton¶
- Title
- 1–2 sentence summary
- Sections with actionable headings
- Links to next relevant pages
For spec pages, prefer: scope → guarantees → non-guarantees → edge cases.