Example result: Write friendly release notes
AI-generated example · Release Notes
Updated

Write friendly release notes

This prompt turns a change list or commit messages into release notes for users or developers in the tone you choose, grouped into New, Improved and Fixed with each item written as a benefit.

text-release-notes-writer — chatgpt — 52 words

Write release notes for version [VERSION] of [PRODUCT] from these engineering changes:

[PASTE CHANGE LIST OR COMMITS]

Audience: [USERS / DEVELOPERS]
Tone: [FRIENDLY / FORMAL]

Group into "New", "Improved" and "Fixed", write each item in a benefit-first sentence and add a short headline. Leave out internal details users do not care about.

Lead with what users can now do, not the technical change behind it.

Get a better result

What you will get

Release notes for your version with a short headline, grouped under New, Improved and Fixed, each item written benefit first for your audience and tone, with internal details left out.

Why it works

Users care about what changed for them, not how, so the prompt asks for benefit first sentences and leaves out internals. The three groups are a pattern people know how to scan. Naming the audience and tone lets the same change list become friendly notes for customers or exact notes for developers.

Common mistake

Items still read like commit messages.

Fix: Ask it to start each item with what the user can now do, as the tip says, and to drop file and function names.

Also watch for
  • Internal refactors appear as features. Mark which changes users can notice, and ask it to leave the rest out or group them as “under the hood”.
  • Big changes and tiny fixes get the same space. Tell it the one or two changes that matter most and ask for those first with a sentence each.
Try a variation: write for developers

Ask for a technical version that lists breaking changes first, with what to change in their code.

Still not right? Reply with this

Write a two line version for an in-app banner and an email subject line, both pointing to the full notes.

More chat & writing prompts

See all 465 →