Bart Krawczyk Learning how to build beautiful products without burning myself out (again). Writing about what I discovered along the way.

What are release notes and how to write good ones

5 min read 1419

What Are Release Notes And How To Write Good Ones

Release notes are often treated as just another tedious formal requirement. That’s so wrong.

Although the brutal fact is that the vast majority of people don’t read them, release notes present a great opportunity to wow the niche that actually reads them.

Well-thought external release notes can help you become more memorable for users. Internal release notes make potential troubleshooting and dependencies easy to fix.

In this article, I’ll cover the topic of external release notes — specifically those shared publicly with users. Let’s see how to write and distribute these effectively.


Table of contents


Writing good release notes

External release notes are usually found in three places:

  • The App Store
  • Google Play
  • A company’s public website

Their official goal is to inform users about recent changes and the content of the patches/updates. And roughly 90 percent of users don’t read them.

But for this remaining 10 percent — which isn’t that small after all — release notes are another touchpoint between them and your product.

The way you use this touchpoint contributes to your overall brand perception. Sadly, most products just bore users with facts. Although there’s nothing wrong with that, there are more interesting ways to convey information than just sharing dry facts.

Let’s take a look at some examples.

Example: Citymapper using release notes to bring some humor

Citymapper proved that there’s an alternative to “minor bug fixes” back almost a decade ago:

Citymapper Release Notes Example Screenshot

Although a bit wordy, combining humor with a little bit of storytelling made these release notes an exciting and memorable read.

What can we learn from these

First and foremost, even minor bug fixes might be presented in an interesting way.

“There are no hoverboards. You must still wear socks” — although these don’t convey any additional information, they fit the storytelling perfectly and make the read more captivating.



Example: Slack using releases notes as a communication touchpoint

Slack took things a bit further. During the COVID-19 outbreak, they used the space solely as a communication touchpoint with users without giving any information about the release whatsoever:

Slack 2020 Release Notes Example Screenshot

If you were one of these 10 percent of users who read release notes, it probably warmed your heart a little. And these notes went so viral that you probably heard about them even without reading them on the App Store, which further reinforced Slack’s brand.

What can we learn from these

Most importantly, release notes can act as an additional communication channel — something between push and e-mail.

It’s also possible to write release notes without actually informing users about the release content. But be careful, this works best for established brands.

Finally, good release notes can go viral, giving you plenty of attention in online media.

Example: Medium keeping it short and sweet

Release notes don’t always have to be wordy. Let’s take a look at one of Medium’s release notes from 2015:

Medium Release Notes Example Screenshot

These release notes can be consumed very quickly while still staying in user memories for longer.

What can we learn from these

Well, sometimes one sentence is enough. A few words, like “fired Peter,” can differentiate between boring and memorable release notes.

Also, don’t hire Peter.


Subscribe to our product management newsletter
Get articles like this to your inbox


Example: Manual sneaking a single bullet point to otherwise standard release notes

Perhaps you prefer the old-school style of release notes, i.e., a bullet-pointed list of changes. That’s okay, but you can spice it up, too:

Manual Release Notes Example Screenshot

Manual made us laugh a few years back by slipping a love confession into their list of fixes one time. Just curious, who was the actual recipient?

What can we learn from these

One additional bullet point to otherwise standard release notes might make a big difference.

Example: Amazon making their release notes easily scannable

Easily scannable and understandable release notes titles are magic. They:

  • Summarize the release notes’ content
  • Allow to easily find the notes we are looking for
  • Help users catch up on months of updates, showing that the product is being developed over time

Amazon Release Notes Example Screenshot

You don’t have to go deep into details to understand what’s happening on Amazon Business. After visiting their release notes site, you already know that a lot is happening for them. You can easily catch up on what you missed and dig deeper into topics you are genuinely interested in.

What can we learn from these

Well-written titles can help users catch up on months of updates. They also show a story of how the product is being developed.

Example: Brainly automating for continuous delivery

All good, but what if you have a robust continuous deployment pipeline? Writing release notes every day is not scalable.

In this case, it’s worth simplifying and automating:

Brainly Release Notes Example Screenshot

What can we learn from these

Release notes can be very generic — there’s no need to write something new every week, especially if you release often.

Distributing release notes

Writing release notes is one thing, but distributing them is a different story.

Although you can’t change the fact that most users won’t read release notes, you can make efforts to increase the number of people that actually read them.

There are a few reasons you might want to do that:

  • It encourages people to update their version of the product
  • It shows them the product grows over time
  • It prompts them to try out and adopt new features
  • It’s another customer touchpoint

While release notes for mobile apps are distributed in stores automatically, there are many ways to increase the reach of notes for both mobile and web products.

Pushes and in-apps

One of the ways is to send users a push notification or some sort of in-app messages, such as a pop-up banner.

These have pretty high discoverability and are among the best ways to ensure users don’t miss a critical update.

A dedicated page

A dedicated page containing all information about releases is a good way to organize and showcase all your hard work. It’s also a must-have for B2B products.

To make it more efficient, move traffic there from other sources (such as the pushes mentioned above). Few people organically search for release notes via Google.

Social media

Although you shouldn’t brag about every single bug fix on your social media channels, more interesting updates deserve some coverage there.

With some luck and well-written copy, you might even go viral.

Media coverage

Do you plan to release a game-changing update redefining the value of your product? That might be worth covering in the media.

You don’t have to buy a Super Bowl slot. Getting coverage on HackerNoon or some other internet publication is probably enough.

E-mail

If you update your app every week, please don’t send an e-mail to your customers every time (although, in some rare cases, it might be acceptable). However, it’s still a viable communication channel worth using when you want to reach as many people as possible with some major updates.

Customer representatives

Some updates might be worth communicating to customers directly. It’s mostly true for B2B products, especially if you deliver an update your key clients have been nagging you about for ages.

Consider using your sales force and account managers to proactively reach out to clients and inform them about major changes you just published.

Other touchpoints

Review all touchpoints you have with your end-users and determine if you can use them as a release communication channel.

For example, you could add a small section with the latest updates on your customer support portal.

Conclusion

Release notes, although often neglected, present you with an opportunity to wow your users and strengthen your brand communication.

Don’t use them just as a medium to convey facts. Think through how you can communicate your values, add some humor, or make your users smile. They’ll remember.

However, if you spend additional effort to write killer release notes, don’t forget the distribution part. You can triple the reach of your release notes if you include actually talking about them in your communication strategy.

Featured image source: IconScout

LogRocket generates product insights that lead to meaningful action

LogRocket identifies friction points in the user experience so you can make informed decisions about product and design changes that must happen to hit your goals.

With LogRocket, you can understand the scope of the issues affecting your product and prioritize the changes that need to be made. LogRocket simplifies workflows by allowing Engineering and Design teams to work from the same data as you, eliminating any confusion about what needs to be done.

Get your teams on the same page — try today.

Bart Krawczyk Learning how to build beautiful products without burning myself out (again). Writing about what I discovered along the way.

Leave a Reply