Release Notes

Definition

Release notes are the deployment work products that formally document a newly released version of the application.

Objectives

The typical objectives of release notes are to:

• Document information describing a newly released version of the application.

Benefits

The typical benefits of release notes are:

• TBD

Contents

The typical contents of release notes are:

• Application Identification (including version and release date)
• Application Description
• New Capabilities
• Defects Fixed (since the previous release)
• Known Defects

Stakeholders

The typical stakeholders of release notes are:

• Producers:
  • Deployment Team
• Evaluators:
  • Deployment Inspection Team
• Approvers:
  • Project Manager
  • Technical Leader
  • Customer Representative
• Maintainers:
  • Customer Organization
• Users:
  • The users user the release notes to learn what has changes since the previous release of the application.
  • Maintenance Team
  • Operations Team
  • User Support Team

Phases

• Business Strategy: Completed
• Business Optimization: Completed
• Initiation: Not Applicable
• Construction: Not Applicable
• Delivery: Completed
• Usage: Maintained
• Retirement: Archived

Preconditions

The release notes can be started if the following preconditions hold:

• The delivery phase is started.

Inputs

Release notes typically have the following inputs:

• Work Products:
  • TBD
• Stakeholders:
  • Software Development Team

Guidelines

• TBD

Conventions

Release notes are typically constrained by the following conventions:

• Content and Format Standard
• MS Word Template
• XML DTD
• Inspection Checklist

Examples

• Example Release Notes