Contributor Frequently Asked Questions¶
How do I…¶
…know if a release note is needed for my change?¶
Reno documentation contains a description of what can be added to each section of a release note. If, after reading this, you’re still unsure about whether to add a release note for your change or not, keep in mind that it is intended to contain information for deployers, so changes to unit tests or documentation are unlikely to require one.
…create a new release note?¶
reno command via tox, e.g:
$ tox -e venv -- reno new brief-description-cool-new-release-note venv create: /home/foo/networking-cisco/.tox/venv venv installdeps: -r/home/foo/networking-cisco/test-requirements.txt venv develop-inst: /home/foo/networking-cisco venv runtests: PYTHONHASHSEED='0' venv runtests: commands | reno new brief-description-cool-new-release-note Created new notes file in releasenotes/notes/brief-description-cool-new-release-note-ecb3875dc1cbf6d9.yaml venv: commands succeeded congratulations :) $ git status On branch test Untracked files: (use "git add <file>..." to include in what will be committed) releasenotes/notes/brief-description-cool-new-release-note-ecb3875dc1cbf6d9.yaml
Then edit the result file. Note that:
we prefer to use present tense in release notes. For example, a release note should say “Adds support for feature foo”, not “Added support for feature foo”. (We use ‘adds’ instead of ‘add’ because grammatically, it is “ironic adds support”, not “ironic add support”.)
any variant of English spelling (American, British, Canadian, Australian…) is acceptable. The release note itself should be consistent and not have different spelling variants of the same word.
Release notes for different plugins should be identified by writing each release note in the following format:
plugin_id: A short summary of the note Full release note text explaining the impact of the change. https://link-to-launchpad.com/bug-or-rfe-if-there-is-one
To check your release notes you can build the documentation locally by running the command:
$ tox -e docs Documentation should build out successfully, or errors about the formatting should appear.
If successful then you can open your browser and view your release notes rendered out with the rest by going to:
For more information see the reno documentation.