> ## Documentation Index
> Fetch the complete documentation index at: https://help.opus.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Help center runbook

# Help Center article runbook

Use this for every create, update, and sunset of a Help Center article. Follow the **Help Center** section of the source doc. Leave Canny, Discord, in-app, and other launch-prep copy out of the article.

## Before editing

1. Fetch the latest `main` and branch from it.
2. Name the branch `MMDD-short-topic` (Lillian's style). Lowercase letters, numbers, and hyphens only. Example: `1026-mcp-tool-catalog`.
3. Change only the articles named in the request. Do not add steps, screenshots, or tools the spec says to leave out.

## Where articles live

| Section | Folder | Public path |
| - | - | - |
| Help Center | `docs/article/` | `/docs/article/<slug>` |
| Agent Opus | `agent-opus/` | `/agent-opus/...` |
| API Reference | `api-reference/` | `/api-reference/...` |
| Opus Labs | `opus-labs/` | `/opus-labs/...` |

The filename is the URL slug. `docs/article/auto-headline.mdx` is `/docs/article/auto-headline`.

## Create an article

1. Add an MDX file with a `title` in the frontmatter.

```mdx theme={"dark"}
---
title: "Article title"
---
```

2. Put screenshots in `images/imgs/`. Reference them from the article:

```mdx theme={"dark"}
<div className="img-frame">
  <img src="/images/imgs/article-name-1.png" noZoom />
</div>
```

3. Add the page path, without `.mdx`, to the right nav group in **both** `mint.json` and `docs.json`. Keep the two files in the same order.
4. Link to other articles with site paths, such as `/docs/article/auto-headline`.

## Update an article

1. Edit the existing MDX. Keep wording the spec says is already fine.
2. When replacing a screenshot, use a new filename so browsers do not keep the old image. Delete the old file if nothing else references it.
3. If a URL is going away, add a redirect. Do not leave the old page live.

## Sunset an article

1. Delete the MDX file.
2. Add the same redirect to `mint.json` and `docs.json`:

```json theme={"dark"}
{
  "source": "/docs/old-path",
  "destination": "/docs/article/current-article"
}
```

3. Delete images that only the retired page used.
4. Leave the replacement article in place.

## Writing rules

* The `style` prop is a JSX object with camelCase keys: `style={{ width: '100%' }}`. Never a string.
* Images must be under 10MB. CI rejects anything larger, and it rejects a `src` that points at a missing file.
* Do not commit screenshots sitting in the repo root. Those are local leftovers.

## Preview

Run `npm run dev` from the repo root and open `http://localhost:3333` plus the article path. Check the changed page before asking for a PR. Do not push until that review is approved.

## Pull request

* One sentence on why, then a short point-form body. No extra commentary.
* Assign the reviewers named in the request.
* A merge to `main` publishes the site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.