Release Notes

Release notes are workspace documents with the Release Note type. Use them when you want a clear narrative of shipped work for customers, stakeholders, or your own team.

Create a release note

Open Documents in the sidebar and create a new document. Set the type to Release Note, write the note in Markdown, and save.

Agents and automations can create the same typed document with MCP create-document using type release_note (aliases: release note, release notes, document_type_release_note).

Share

Copy the note as Markdown or send it to another tool, such as Slack, a docs site, email, or a changelog.

Pick the audience

Write a separate note per audience when the same work needs different framing:

Audience	Emphasize
External	User-facing changes, improvements, and product value without internal implementation detail.
Internal	Implementation notes, resolved blockers, decisions, and next steps.
Stakeholders	Outcomes, risk, customer impact, and strategic progress.

Get better release notes

Clear pull request descriptions and comments produce clearer notes. Captured work explains how completed work is collected. Use completed work lists and initiative briefs as sources when drafting.