Navigation Model

The documentation tree is the source of truth for navigation.

Folder to sidebar mapping

Top-level section folders become top-level sidebar groups when they are registered in astro.config.mjs:

src/content/docs/
  getting-started/
  concepts/
  deployment/
  reference/

Each folder can contain:

• index.md for the section landing page
• leaf pages like local-preview.md
• nested folders when a section needs deeper organization

Practical rule

If a page should appear beside its peers in navigation, place it in the same folder as those peers.

That keeps the left nav predictable and makes content moves straightforward in pull requests.