Release Notes Schema Specification
The goal of this repository is to work out an easy to use, human readable and machine processable YAML schema specification for release notes.
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
The release notes MUST be defined in a
release-notes.yml file on project root.
The format of that file MUST be YAML.
The document MUST provide a title.
The document SHOULD provide a description.
The document MUST prodive releases, an array of
The releases SHOULD be ordered, the latest release comes first.
A release MUST provide a version.
A release MUST provide a date of type
A release MAY provide a title.
A release SHOULD provide a description.
The Upcoming Release
An upcoming release MUST have the version set to
The upcoming release MAY omit the date info.
A release MAY provide a list of added functionality.
A release MAY provide a list of removed functionailty.
A release MAY provide a list of changed functionailty.
A release MAY provide a list of improved functionality.
A release MAY provide a list of deprecated functionality.
A release MAY provide a list of fixed functionality.
A release MAY provide a list of secured fixes.
All modification list items MUST be either string or an object with a title property.
A modification in object notation MAY provide a list of tags. Each tag MUST be a string that SHOULD be treated case insensitive.
title: Release Notes of an awesome project description: > Awesome project makes your cli a better place. releases: - version: Unreleased added: - Add more fancy stuff. deprecated: - Deprecate some "not so awesome" command. - version: 0.1.1 date: 2017-10-30 fixed: - title: Do not crash on win32. tags: ["Windows"] - version: 0.1.0 date: 2017-10-30 description: The first release added: - Introduce some awesomeness.
The Release Notes project consists of the following repositories:
- Release Notes Hub
- Release Notes CLI Tool
- Release Notes Node.js lib
- Release Notes Specification
- Release Notes JSON-Schema Definitions
The files in this archive are released under MIT license. You can find a copy of this license in LICENSE.