Brainstorming release notes to be better

Hey team,

Over the past couple of years (since Sally stopped writing our release notes) we’ve worked hard to make them more useful and also well integrated into our delivery process.

But talking about them with @Rachel and @sauloperez in BCN, we believe they could be even better.

So I’m creating this topic for us to gather great examples of how other software companies communicate to their users about the changes they implement, that can inspire us to start doing ours in an even more user-friendly way :smiley:

Feel free to add examples to this topic if you know of any that you believe are great :ok_hand:

1 Like

Notion release notes

These guys put out a release every couple of weeks, and have a place where they announce and explain the changes.

Their releases seem to include a particular feature alongside of the bug fixes and small improvements.

I really like how they use screenshots and videos to explain how the new features work. And they link to further information where they have it (e.g. userguide).

Slack updates

Slack have in-application notifications about changes to their software that you can access via the main menu. This section has a small blurb about the change and then links to a blog post when more detail is available.

I really like the way they don’t talk specifically about releases, but just focus on what the user can now do and don’t do a big list of things but break them out into their own snippets. And they don’t necessarily talk about bug fixes but more about interaction/feature changes.

Github is also a great example of small and tailored blog posts aimed at explaning new features such as

They briefly introduce them and point to a documentation page for detailed information.

Besides, they also highlight the announcement of particular features taking what Slack does one step further.


Another great example. Figma has a where they focus on the most relevant feature changes with lots of images an explanations, linking to docs. At the same time they also have (and link from what’s new) a where they list the relevant changes included in each release but still described in a user-focused way with gifs and images.

Looks like something that would fit us perfectly.

In these examples, the things I think will work well for us:

  1. integration of screenshots or animation - don’t have to be as fancy and perfect as some of these examples - just a simple screenshot is great
  2. keep in mind who the communication is for - ie: primarily non-dev users I think - right?
  3. keep an archive/history (like in the blog posts) of previous releases - since we should anticipate that users will not race to reach each one as soon as we put it out
1 Like

It turns out ZenHub also has nice release notes

oops I forgot to post, the Slack ones’ I’ve posted on the communication channel