Contributing
Page templates
Copy-ready MDX templates for each documentation type.
Tutorial
---
title: Do the thing from start to finish
description: One sentence describing the outcome.
---
What the reader will have at the end, and who it is for.
## Before you start
- Prerequisite one.
- Prerequisite two.
## 1. First step
What to do and what to expect.
## 2. Second step
What to do and what to expect.
## Verify
How to confirm it worked.
## Next steps
- [Related page](/docs/...)How-to guide
---
title: Create a coupon
description: Create a discount code with limits and a validity window.
---
When to use this workflow.
## Before you start
- Permission required.
- Data or setting required.
## Steps
1. Open **Marketing → Coupons**.
2. Select **New Coupon**.
3. Fill in the fields.
4. Save.
## Verify
Where to confirm the coupon exists and is active.
## Troubleshoot
- **Symptom:** cause and fix.
## Related
- [Coupons](/docs/merchant-guide/coupons)Reference
---
title: Order statuses
description: Every order status and the allowed transitions.
---
One sentence of context.
## Statuses
| Status | Meaning |
| --- | --- |
| Pending | ... |
## Allowed transitions
| From | To |
| --- | --- |
| Pending | Confirmed, Canceled |Explanation
---
title: Architecture
description: How the apps, packages, and services fit together.
---
The problem this design solves.
## Overview
A short diagram or text flow.
## Key decisions
- Decision and why.
- Trade-off and when to revisit.
## Related
- [API and SDK](/docs/developer-guide/api-and-sdk)API page
Do not write API pages by hand. Add or change the oRPC procedure, then run:
pnpm docs:sync-apiHand-written API overview pages belong in content/docs/api-reference/index.mdx.