Skip to content

Concepts

The docs site is designed around three simple ideas:

  • Documentation is source-controlled alongside the product.
  • Authors write plain Markdown files.
  • CI builds static HTML and publishes the result without requiring an application server.
  • It is easy to review docs changes in pull requests.
  • Build output is cheap to host.
  • The docs can evolve in the same repo as the product without coupling them to the main web app runtime.

Read Navigation Model for the section and sidebar structure.