Writing pages

Frontmatter

title is required, description is optional and shows under the heading and in search results.

---
title: Deploying
description: How releases reach production
---

Linking

Relative file paths resolve to page URLs, so links survive a rename:

See [Home](./index.mdx).

Sidebar order

Without a meta.json, pages are listed alphabetically. Add one per folder to pin the order:

{
  "pages": ["index", "writing-pages"]
}

Folders

A folder becomes a sidebar group. Give it a name with its own meta.json:

{
  "title": "Guides",
  "pages": ["deploy"]
}