Product teams · builders
Make a release understandable.
The release notes say what changed. Your audience needs to know why it matters to their work.
Start simply
Paste the relevant release note and choose the reader.
The material
- Change
- A failed CSV import now identifies the row that needs attention.
- Reader
- An operations lead importing their first file.
- Evidence
- A reviewed release note and a screenshot using test data.
- Limit
- Bulk editing is still being explored.
Preparation with Tellshift
A draft that connects the problem, the released change and its limits, with the source alongside it.
Your decision
Confirm the change is public, the screenshot is permitted and the wording matches what shipped.
A useful next step
Give the right reader a reason to try the change or explain what still gets in their way.
Example message · fictional project
When you need more control
Optional choices for this workflow. Keep the first pass simple.
- Audience
- Separate a customer explanation from a technical changelog.
- Review
- Name the person who can confirm the release and any permitted image.
- Follow-through
- Choose the question or product action you want to learn from.
Product direction · proposed
Observe selected release sources and suggest a new capture when an accepted change is worth explaining.