Writing content

Sections & pages

How the content tree maps to navigation and URLs.

The tree is two levels deep by design: sections group pages, pages hold blocks. A page lives at /docs/<section-slug>/<page-slug>, and the sidebar mirrors the array order exactly — reorder the arrays to reorder the navigation.

export const DOCS: DocSection[] = [
  {
    slug: 'guides',
    title: 'Guides',
    pages: [
      { slug: 'installing', title: 'Installing', description: '…', blocks: [] },
      { slug: 'configuring', title: 'Configuring', description: '…', blocks: [] },
    ],
  },
]

Reading order

Previous/next links walk the tree in order, flowing across section boundaries — the last page of one section links forward to the first page of the next. Write sections so they read well front to back.