openstack/keystone
Code Issues Proposed changes

[doc] point release note docs to project team guide

Browse Source 
no point in maintaining our own doc, the project team guide
(not to be confused with the other PTG) already documents
when and how to create release notes.

Change-Id: I894b335fbb1d4b16d1813c11c9dc912dcbf55bba
This commit is contained in:
Steve Martinelli 2016-12-20 10:35:04 -05:00
parent 91167ad58a
commit dbb05ae5d5
1 changed files with 6 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
doc/source/devref/development_best_practices.rst
View File

@ -158,43 +158,13 @@ found in ``config-generator/keystone.conf``.
Release Notes Release Notes
============= =============
The release notes for a patch should be included in the patch. If not, the The Keystone team uses `reno <http://docs.openstack.org/developer/reno/usage.html>`_
release notes should be in a follow-on review. to generate release notes. These are important user-facing documents that must
be included when a user-facing change is performed. A release note should be
If the following applies to the patch, a release note is required: included in the same patch the work is being performed.
* The deployer needs to take an action when upgrading
* The backend driver interface changes
* A new feature is implemented
* Function was removed (hopefully it was deprecated)
* Current behavior is changed
* A new config option is added that the deployer should consider changing from
the default
* A security bug is fixed
A release note is suggested if a long-standing or important bug is fixed.
Otherwise, a release note is not required.
Keystone uses `reno <http://docs.openstack.org/developer/reno/usage.html>`_ to
generate release notes. Please read the docs for details. In summary, use
.. code-block:: bash
$ tox -e venv -- reno new <bug-,bp-,whatever>
Then edit the sample file that was created and push it with your change.
To see the results:
.. code-block:: bash
$ git commit # Commit the change because reno scans git log.
$ tox -e releasenotes
Then look at the generated release notes files in ``releasenotes/build/html`` in
your favorite browser.
For more information on how and when to create release notes, see the
`project-team-guide <http://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes>`_.
Testing Keystone Testing Keystone
================ ================