Skip to content

Content Architecture

Design the documentation around how teams actually browse and update pages.

Principles

  • Group by user intent.
  • Keep folder depth shallow.
  • Prefer stable section names.
  • Put templates in a separate folder.
  • Use indexes as entry points for each section.
  1. Overview
  2. Setup
  3. Usage
  4. Reference
  5. Troubleshooting
  6. Changelog

Markdown-first documentation for teams that update docs often.