Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How should release notes be written?

Is there any sort of guidelines or best practices on how release notes should be written? I guess I am trying to find the proper balance between making the point without being too specific. Also, do developer usually provide a much more release notes for QA team compare to the one submitted for public view?

like image 366
DeFiNite Avatar asked Mar 12 '09 12:03

DeFiNite


People also ask

What do good release notes look like?

First, you should have a simple language that is easy to understand. Second, the release notes should be short. Third, they should be grouped logically and not randomly. Also, Relevant links should be included.

How do you write a first release note?

The first thing to include in your release notes post is your header, which should include the product name, release number and date of release for clarity. Next, you'll need to include a brief overview of what you're including in your release notes, including all new features and important info.

What is release notes template?

A software release notes template is a simple document that SaaS companies use to document any changes to their product. Release notes templates are used to communicate: product updates, bug fixes, new features, and other small or big changes that happen in your product.


1 Answers

Public release notes should contain at least:

  • release, buildnumber
  • all fixed public bugs
  • all added public features

QA release notes should contain at least:

  • release, buildnumber
  • all fixed bugs including bug number
  • all added features including links to design docs

Consider your audience and try to think what they need.

An other thing to add is new or discontinued support for certain platforms. (For example we quit support for Win3.1 and added Vista 64 bit).

like image 128
Toon Krijthe Avatar answered Sep 16 '22 19:09

Toon Krijthe