Quickstart

1. Create a branch

git checkout -b docs/nimbus-queues

2. Add a Markdown file

Create src/content/docs/guides/queues.md. The file path is the URL, so this page will be served at /guides/queues/.

---
title: Queues
description: Durable background jobs for Nimbus.
---

Queues buffer work between services.

3. Add it to the sidebar

Pages under getting-started/, guides/ and reference/ are picked up automatically by autogenerate in astro.config.mjs. The label comes from the frontmatter title, and sidebar.order controls position:

---
title: Queues
sidebar:
  order: 3
---

4. Preview and push

pnpm dev          # check it renders
git commit -am "docs: add queues guide"
git push -u origin docs/nimbus-queues

The pull request gets a preview deployment URL from CI within a couple of minutes.

5. Merge

Squash-merge to main. The deploy workflow builds the commit and publishes it. Nothing else is required.