Skip to content
Arashi logoArashi

How to Add Pages

Workflow

Section titled “Workflow”
  1. Choose the destination section: getting-started, commands, or contributing.
  2. Create a new Markdown file under docs/<section>/.
  3. Add frontmatter:
---
title: Your Page Title
description: One sentence explaining why this page exists.
---
  1. Add links from at least one section index or related page.
  2. Update sidebar navigation in astro.config.mjs if the page needs top-level visibility.
  3. Run validation commands before opening a pull request.

Required Checks

Section titled “Required Checks”
Terminal window
bun run lint
bun run validate:links:internal
bun run validate:a11y

Review Expectations

Section titled “Review Expectations”