# Write a changelog

Generate a changelog using context from your connected sources.

## Prerequisites

Recommended [sources](/docs/set-up/connect-sources) for a high-quality changelog:

- Connection to GitHub to find recent pull requests
- Connection to Linear to find recent tasks

## Draft the changelog

Falconer searches your connected Linear issues and pull requests to generate a changelog.

**Steps:**

1. Click the **+** icon in the left sidebar to create a new doc.
2. In the agent chat, be specific about the time range, team, or project you want to cover. Example prompts:

```markdown
Write a changelog for the last two weeks
```

```markdown
Summarize what the engineering team shipped this sprint
```

```markdown
Create a changelog for the payments project dating back to January 1
```

```markdown
Write release notes for everything completed last month, grouped by theme
```

## Collaborate on the changelog

Alternatively, you can collaborate with Falconer from the homepage with a more guided approach. Falconer will prompt you with questions before writing the changelog.

![](/docs/images/write-a-changelog-collaborate.png)