# Linear

> The usedocs Linear integration turns issues into help article drafts. Mention @usedocs in a comment on an issue, or complete an issue that has the docs label, and usedocs drafts the article from the issue's description and comments. It replies on the issue with a link, and the draft waits in your re

usedocs keeps a SaaS help center accurate from your code and your customers, and Linear adds the place where your team plans the work. After you connect Linear, two things start a draft. Mention @usedocs in a comment on any issue, and usedocs reads the issue's title, description, and comments and drafts the help article it needs. Or add the docs label to an issue, and when the issue is completed, usedocs drafts the article then, so the docs are ready around the time the feature ships. Either way, usedocs replies on the issue from its Linear app with a link to the draft, so the whole team can see the docs are in hand. Drafts arrive with a reader facing title, a description, and a suggested collection, and wait in the same review queue as edits from merged pull requests and drafts from customer questions. One draft per issue: a second mention while a draft is open doesn't create another.

## Set it up

1. **Open Integrations.** In the usedocs dashboard, open Integrations and find Linear under Docs and code.
2. **Connect your Linear workspace.** Approve the usedocs app in Linear. It can read issues and post comments, so it can reply with draft links.
3. **Add a docs label.** Create a label named docs in Linear, if you don't have one, for issues whose completion should produce a help article.
4. **Mention or label an issue.** Comment @usedocs on an issue, or complete an issue labeled docs, then review the draft from the link usedocs posts.

## What it does

- **Drafts on @usedocs mentions.** Mention @usedocs in a comment and get a draft written from the issue and its discussion.
- **Drafts when docs issues finish.** Completing an issue labeled docs starts a draft, so documentation lands with the feature.
- **A reply on the issue.** usedocs comments on the issue with a link to the draft, so nobody wonders whether the docs are done.
- **One review queue.** Linear drafts wait next to edits from merged pull requests and drafts from customer questions.

## Good to know

- Drafts are proposed, never published without approval.
- One open draft per issue; mention again after the draft is approved or dismissed for a new one.
- Drafts count toward the AI drafts allowance on Growth under fair use; if drafts are paused, usedocs says so on the issue.
- The issue's title, description, and comments are the source, so a thin issue produces a thin draft.