Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Document Properties Marker
overridefalse
Short DescriptionDocument changes provided by a release of a product. 
Doctypedoctypehide
NameRelease Note 
IDrelease-note 
SetProject Management 
Parent
Parent Property
parent-doctypetopic
property-nameName
 
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
propertyAudience
 
Documentation Type
Name List
doctypedoctype-type
render-no-hits-as-blanktrue
namesQ2 - Project
propertyDocumentation Type
 
Categories
Name List
doctypecategory
names/ Project, / Work
 
Tags
Tag List
 
Iteration

Iteration
value

facade

finished

hide
Sort Keyhide
Section
indextrue
titleDescription

Release notes provide information of a new version of a product to its customers and users.

Section
titleProperties
Transclusion
documentNote Box referencing common Document Properties
idsBox

Section
titleType

Specify a type to organize your release notes.

Section
titleVersion

Specify the version of the product described by this release note.

Section
titleProduct

Name the product and provide a link to further information for this product.

Section
titleRelease Date

Specify the date the product was released.

Section
titleSponsors

List the stakeholders that take special interest in this release or are specially involved in this released version.

Section
titleSections
Section
titleDescription

Describe the purpose of this release notes document.

You may add also information about the product to help readers to determine, if this document is relevant for them.

Section
titleSummary

List the main features of this release and the most important information for users to decide whether to select this version or not. This is usually about three paragraphs long.

Section
titleNew and Noteworthy

 Describe the most interesting changes in more detail.

Section
titleRequirements

List requirements for the new version of the product.

Section
titleBreaking Changes

Describe changes that remove or break existing features that require the users attention.

Section
titleKnown Issues

List known issues with this release and provide workarounds and links to track the issues.

Section
titleInstallation Instructions

Provide information on how to install this release. If these instructions do not differ from previous release you may simply reference the installation instructions from here. This helps users to quickly access them. You may also want to provide links to the user manuals or getting started guides.

Section
titleUpgrade Instructions

 Provide information on how to upgrade to this release. This may include creating a backup of personal data or migration instructions.

Section
titleList of Changes

If the JIRA server is configured, this section lists the issues associated with this version of the product.

The query to select the issues is based on the version property of the release note.

Code Block
languagetext
project = 'MY_PROJECT_NAME' && fixVersion = 'MY_VERSION' ORDER BY type DESC, priority DESC
Transclusion
documentDocument Sections
idsstandard-sections-bottom

Section
titleDetails

Section
indextrue
titleRelated Doctypes
Section
titleRelease Note Type

The Release Note Type allows to group release notes for your products and services.

Section
indextrue
titleSub-Doctypes
Display Table
doctypedoctype
render-no-hits-as-blanktrue
selectName, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name

...