Those Pesky Release Notes and Product Management
February 6, 2014

Those Pesky Release Notes and Product Management

by Brian de Haaff

Release notes are unglamorous — unless you need to know what was just released. There’s no shame in admitting they they are a pain to write and often get ignored.

Yet it’s critically important for your product development team to complete them if you are working in a mid- or large-sized software or web company, or in a growing business with lots of end users who need to know what’s new. Release notes are a key way to share with internal stakeholders and customers what’s fresh or changed in your software or service.

Unfortunately, most teams never create them, because they do not have a good tool to track features and their corresponding release notes in one place.

Release notes may be written by a technical writer or any other member of the product, development or test team. Oftentimes it’s a collaborative process that is part of the product launch process. The key is to make sure to at least capture the name of the feature, a short description, and the benefit of the functionality or bug fix. It’s even better if you can add a few diagrams and screenshots to explain how it works.

And just because you are agile is no excuse not to document what you just released. The rest of the organization still needs to know what went out the door and why it matters.

The challenge has historically been that it is difficult to track what was implemented and have easy access to the roadmap, feature descriptions, and requirements in one place. Aha! makes it easy to draft release notes and attach them directly to the features. You can add release notes by using the Custom fields control in Aha! under Account settings. Choose the Notes custom field and position it at the bottom of the page below requirements.

Blog - Those Pesky Release Notes and Product Management - inline image

This kind of information gives readers of the document a total view of what was delivered and the benefit of the new functionality. Capturing them as you are doing your release planning makes it easier to share or export the data when you are done. And it definitely makes it easier for someone else to write the release notes, even if they are not in product management or engineering.

Blog - Those Pesky Release Notes and Product Management - inline image

Release notes are typically circulated only after the product or service has been tested and the features are live. They are also an excellent mechanism to capture the critical information for user guides, marketing materials, and revisions to training materials.

Blog - Those Pesky Release Notes and Product Management - inline image

Brian de Haaff

About Brian de Haaff

Brian seeks business and wilderness adventure. He is the co-founder and CEO of Aha! — the world’s #1 roadmap software — and the author of the bestseller Lovability. Brian writes and speaks about product and company growth and the adventure of living a meaningful life.

Follow Brian

Follow Aha!

Related articles

The Best Cover Letters That CEOs Love to Read
April 13, 2017

The Best Cover Letters That CEOs Love to Read

You are probably familiar with the “elevator pitch.” You know, the one-minute speech every seasoned salesperson has memorized to deliver at a moment’s notice. It may be a cliche,…

Stop Being so Fixated on Your Next Job Title
April 2, 2019

Stop Being so Fixated on Your Next Job Title

Have you ever quit a job because you did not get the promotion or title change that you wanted? I considered doing so myself in the past and know a few people who actually have.…

Hey Boss: Stop Being My Timekeeper
August 8, 2017

Hey Boss: Stop Being My Timekeeper

“Let’s get it done ASAP.” How many times have you heard this from your boss? Maybe it was an urgent phone call or an email flagged as “high priority.” The pressure of a countdown.…

See why more than 400,000 users trust Aha! to build products customers love

Start your free 30-day trial

© 2020 Aha! Labs Inc.All rights reserved