Release notes
Release notes describe important information about a distribution of a hardware or software product. Often, release notes accompany an update to a product that was released previously and is in use. But they may also be available for a product still in the development or being tested. Release notes are typically shared with end users, customers and clients of an organization.
Alternate names used and related information includes changelog, release logs, software changes, revision history, updates, or README. Often release notes and changelog are published separately to allow for differentiation of feature highlights from bugs, change requests, and other improvements. Release notes differ from end-user license agreement, since they do not contain any legal terms of the software product or service. The focus should be on the software release itself, not for example legal conditions.
Release notes might be provided as an artifact accompanying the deliverables for system testing and system integration testing and other managed environments especially with reference to an information technology organization. Release notes can contain test results and information about the test procedure. This kind of information gives readers of the release note more confidence in the fix/change done; this information also enables implementer of the change to conduct rudimentary acceptance testing.
Release notes can describe how to install or build software, instead of highlighting new features or resolved bugs. Another term often used in this context is system requirements: the hardware and software required for installing, running or building the software.
Content
With no standards, both format and content vary.Generally, release notes are a terse summary of recent changes, written in the present tense and include information such as:
; Header: Document name, product name, release number, release date, note date, note version, etc.
; Overview: A brief overview of the changes and in the absence of other documentation, the product as well.
; Purpose: Describes the purpose of the document.
; Issues: A list of what is new in the release, including bug fixes and new features.
; End-user impact: What different actions are needed by end-users. This should include whether other functionality is impacted by these changes.
; Support impacts: Changes required in the daily process of administering the software.
; Notes: Other information such as installation, upgrades and product documentation
; Disclaimers: Company and standard product-related messages. See also disclaimer.
; Contact: Support contact information.
The Release Notes Schema Specification is a proposed specification for a release notes document.