Brought to you by Slite, a communication tool that empowers remote-first teams.

The art of writing great Release Notes

8 min
September 27, 2020
Get your release note template
Looking to write release notes that customers actually read? Follow this guide and be inspired by some of the best notes of release examples.

If you're a product-led team or even a product-led business, then you're probably familiar with release notes and what they're for—no worries if not, we'll get to that.

The art of writing release notes that rock is a tricky form of writing to conquer. Fear not, this article is here to guide you through writing perfect release notes and share some leading examples.

What are release notes?

A release note is an ongoing instructions manual that guides the user on how to get the most out of a new product or product update.

Today, rapid prototyping leads to early releases of products or at least MVPs, and data feedback drives many renditions, consumers are no longer buying software product for life. They're expecting to buy a version of that product in its current state, knowing bug fixes and improvements will continue to evolve as they do.

Product updates, app updates, status updates, or new features come into play here as well. A business can't implement a new feature or changes to a software product  without informing the user of the changes they've made. Product release notes act as an user guide to inform users of everything that's changing, why, and what new benefits this brings the consumer.

Why are release notes important?

Release notes are a customer-facing technical documentation; they're a reflection of all the hard work your software product developers, engineers, and researchers have put in behind the scenes to bring your customers the most valuable product possible. They are your business's opportunity to show users that you care and that consumers have the latest version of your product.

Plus, release notes are an educational piece of material for your users. New feature releases in digital products can often be frustrating if not communicated clearly—especially when customers are used to things being a certain way.

Notes of release are your opportunity to retain user engagement, and potentially build it, while focusing on performance improvement and building a more valuable product.

Best practices for writing release notes that rock

Let's dive into the thick of it all and explore some best practices for creating your release notes that serve their purpose with style.

1. Keep them brief

Firstly, try to keep your notes as brief as possible. Think about the length of a tweet. Can you fit your release notes into 280 characters? If you can, while still getting across everything you need to, then go for it.

The shorter, the better—just don't cut information or lose personality in the process.

2. Avoid jargon

You'll be surprised by the amount of in-office or tech jargon you pick up behind the scenes. Remember, your customers are customers because you're providing a solution to something they can't do themselves. This likely means they won't be familiar or comfortable with the same javascript or technical vocabulary as you.

Keep this in mind and write as plainly as possible.

3. Stay educational

Yes, our notes of release are an opportunity to engage with customers and showcase our charming, witty, kind, branded tone of voice, but remember this content is educational.

Ensure your release notes serve their purpose and keep them informative.

4. Show customers you care

You're announcing product updates because you've learned that your product can be a better solution. You care about your customers and their experience with your business, so showcase it.

Let customers know you're putting them first, and you've implemented changes to help them.

5. Keep distribution channels in mind

There are so many different ways of announcing release notes and product changes:

  • Social Media
  • Web pages
  • Product faqs
  • Web apps
  • Security updates
  • Email
  • In-app messaging
  • Blogs,
  • Android play store bios
  • Apple macOS or ios app store bios
  • Linux
  • SMS

The list is long. Consider your distribution strategy and the amount of info you can provide on that channel before linking to more information, or even if you need to.

6. Get visual

The mind processes images 6,000x quicker than it does text. If you can explain something better with an image over copy, then do so. Let images lift the overall experience of your customers and the notes of release.

If you're writing for a channel that doesn't support images, then consider emojis, or font formatting options instead.

7. Make them fun

Admittedly, release notes don't have the most exciting of names. However, don't let this affect the view your customers have of them. Make your release notes fun, engaging, and even something that customers look forward to.

Think of innovative ways you can showcase change, and lighten what is stereotypically a dull experience.

8. Get feedback on them

Lastly, on our list for best practices when writing good release notes, is to ask for feedback. Find ways to survey your customers and get their feedback on how you're delivering release notes and product changes.

Try to target an array of customers, from those that have only been with you for a couple of months to those that were there from day one. Everyone will have interesting insights to share—if they have the time and incentive to share them.

5 great examples of release notes

There are some great release notes out there. It's a good idea to think of some from your favorite brands or try a Google search to find some specific to your industry.

Whether announcing new keyboard shortcuts, updated color pickers, CSS changes, whatever it is your business does and is upgrading, we've collected a few top examples, inline with release notes best practices to help get you on your way.

Codility—the one with the GIFs

Codility, the recruitment platform to remotely hire engineers and developers, keep things simple with their product release notes. Codility announces new features and product changes clearly and gives precisely the right amount of information their customers need.

What's different about the way they do it? The power of the GIF. It's a simple tool that is greatly overlooked by many companies looking to spice up the visual elements of their campaigns.

release notes walkthrough
Source

GIFs can be a great way to give a quick tutorial of your new product or feature release while being a low lift to create and having a minimal effect on a page load speed.

Slack—the one with the campaign

Slack updates and changes
Slack product update April 2021

Slack has a fantastic reputation for communication, and so they should, with a mission attempting to transform business communication. Their release notes go a step further and they create entire campaigns around release notes.

In September of 2020, Slack released Slack Connect, a new feature that allows multiple organizations to connect in the same channel and work together in real-time—essentially eradicating emails.

However, just announcing this massive new feature wasn't enough. Slack built user cases around it with real businesses, landing pages for it, and a social media content plan supported by smart graphics and smarter copy.

The entire campaign is on-brand and ensures their customers—or potential customers—have a 360° view of this new feature, what it can do, and inspiration for how to use it.

Teamwork—the one with the release notes roadmap

A great example of showing customers you care. Teamwork gives their customers a complete roadmap of the things they're working on. They have an insightful combination of updates done recently, a short overview of them, and an option to click through and learn more.

Teamwork release notes screenshot
Source

Teamwork is actively showing customers that they're always working with this product roadmap. Their roadmap solution is for current customers wondering what's to come and potential release dates. Plus, these latest updates can act as a selling point for customers considering their solution over the competition.

Brawl Stars—the one that’s fun!

We're branching away from SaaS for a moment to take a look at how the B2C world creates release notes. The gaming industry is massive, and many industries can learn a lot from the communities they're building and the enjoyment they're plugging into development updates.

Brawl Stars is an incredible example of how notes of release can be done well and come in different content forms. The game goes through drastic updates and communicates these via a Youtube series: Brawl Talk. The video is a combination of informative and educational while staying true to their brand and appeasing their fans and followers.

Brawl Stars Release Notes
Brawl Stars Release Notes July 2020

Think about ways your own business can take the engagement strategy, energy, and ultimately fun. They're plugging into their release notes and putting an innovative product spin on release notes of your own.

Unsplash: the one keeping it brief

Unsplash, the image sourcing online catalogue, delivers their release notes briefly, avoiding too much technical jargon, and uses images to lift the customer's experience.

The stock image library is constantly building out new integrations and features to ensure they stay on top, which means many changes, a lot of the time.

However, they've chosen an appropriate format to deliver their release notes—email. They give people a good overview of changes without scrolling through too much content they don't want to read.

Unsplash Product Updates
Unsplash Platform Updates March 2020

Who should write release notes?

Release notes are essentially customer-facing marketing material and need to be treated specifically with end users in mind. Don't let your developers or engineers write your release notes. Yes, they can write briefs of them, but these briefs need to go to your content marketing team.

Release notes need to radiate your brand, be understandable for consumers, and delivered with a tone of voice people recognize. They need to be written with the end user experience in mind, as much as the same thoughts lead product innovation.

Let your writers understand what's new and suitably explain the change to your audience, just ensure your product launch team can proofread their work before launching.

What is the best way to share release notes?

The best way to share your release notes and let your users know about your product updates is the following:

  • Newsletter: Instantly let your most loyal users know about important updates on your product.
  • Facebook Groups: Create a buzz about your awesome new product features by creating a sharable post.
  • Website Home Page: let every visitor know there's more to try.

Wrapping up our guide on how to write release notes

That's everything you need to know on release notes. Remember, from the android play store to the company blog, keep them brief, on-brand, and innovative where you can. Release notes don't need to be on every communication channel you have; it's down to your business to decide where's best to publish them, as well as how to do so.

If you're looking to create release notes for your product or product features, then we've got you covered. Use this free release notes template and start writing release notes that elevate your brand and your customers' experience with your product.

Written by

Clement Rog is working in our Marketing team from Lyon, France. His focus is on bringing remote teams to Slite and making sure they become happy users. Besides that, Clement loves geography, talking about ethical marketing on Twitter @clementrog and spending some good time with his partner and their son.