openstack/magnum
Code Issues Proposed changes
0dee6ab20a
magnum/doc/source/contributor/reno.rst
Madhuri Kumari b172f1cfd4 Move the contributor related docs to contributor/ dir 
Please refer http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html
for more details.

Change-Id: I7c8c76cf98c7538bf28c8fdb520121be4c1ca4c3
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
2017-07-13 11:18:41 +05:30

2.3 KiB
Raw Blame History

Release Notes

What is reno ?

Magnum uses reno for providing release notes in-tree. That means that a patch can include a reno file or a series can have a follow-on change containing that file explaining what the impact is.

A reno file is a YAML file written in the releasenotes/notes tree which is generated using the reno tool this way:

$ tox -e venv -- reno new <name-your-file>

where usually <name-your-file> can be bp-<blueprint_name> for a blueprint or bug-XXXXXX for a bugfix.

Refer to the reno documentation for the full list of sections.

When a release note is needed

A release note is required anytime a reno section is needed. Below are some examples for each section. Any sections that would be blank should be left out of the note file entirely. If no section is needed, then you know you don't need to provide a release note :-)

  • upgrade
    • The patch has an UpgradeImpact tag
    • A DB change needs some deployer modification (like a migration)
    • A configuration option change (deprecation, removal or modified default)
    • some specific changes that have a DocImpact tag but require further action from an deployer perspective
    • any patch that requires an action from the deployer in general
  • security
    • If the patch fixes a known vulnerability
  • features
  • critical
    • Bugfixes categorized as Critical in Launchpad impacting users
  • fixes
    • No clear definition of such bugfixes. Hairy long-standing bugs with high importance that have been fixed are good candidates though.

Three sections are left intentionally unexplained (prelude, issues and other). Those are targeted to be filled in close to the release time for providing details about the soon-ish release. Don't use them unless you know exactly what you are doing.