Adding Content

New documentation pages go in src/content/docs/. The directory structure maps directly to URL paths.

Creating a page

Create a .mdx file with YAML frontmatter:

---
title: "Page Title"
description: "A concise description of the page content."
---

Your content here.

File format

Use .mdx as the default format. MDX extends Markdown with JSX support, allowing you to import and use interactive components directly in your content.

Sidebar placement

Pages are auto-generated into the sidebar based on their directory. Place files under the appropriate Diátaxis category:

• tutorials/ — Learning-oriented, step-by-step
• guides/ — Task-oriented, problem-solving
• reference/ — Information-oriented, lookup
• resources/ — Understanding-oriented, explanatory