Add revision history sections

Add a table at the end of each policy where we can highlight major
revisions. This is different than the more detailed history section
above, which is combined with the alternatives, because it is just meant
to give a summary.

Change-Id: Id24b077cfbb3d2ee6ae66eb33033347760056399
This commit is contained in:
Doug Hellmann 2015-02-03 12:05:58 -05:00
parent 1669e9fe07
commit c6af4d9fe8
7 changed files with 90 additions and 0 deletions

View File

@ -108,7 +108,16 @@ are:
* Anything else you feel it is worthwhile to refer to * Anything else you feel it is worthwhile to refer to
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* -
- Introduced
.. note:: .. note::

View File

@ -289,12 +289,36 @@ References
marking it obsolete: marking it obsolete:
http://lists.openstack.org/pipermail/openstack-dev/2014-August/044360.html http://lists.openstack.org/pipermail/openstack-dev/2014-August/044360.html
* `Taking the Long View
<http://www.slideshare.net/doughellmann/taking-the-long-view-how-the-oslo-program-reduces-technical-debt>`_,
Kilo summit presentation by Doug Hellmann and Mark McLoughlin with
some history of the incubator.
.. _Oslo/CreatingANewLibrary: https://wiki.openstack.org/wiki/Oslo/CreatingANewLibrary .. _Oslo/CreatingANewLibrary: https://wiki.openstack.org/wiki/Oslo/CreatingANewLibrary
.. _oslo-incubator project: https://launchpad.net/oslo-incubator .. _oslo-incubator project: https://launchpad.net/oslo-incubator
.. _Oslo/GraduationStatus: https://wiki.openstack.org/wiki/Oslo/GraduationStatus .. _Oslo/GraduationStatus: https://wiki.openstack.org/wiki/Oslo/GraduationStatus
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Essex
- Incubator created as ``openstack-common`` repository
* - Folsom
- "Managed copy and paste" concepts developed
* - Juno
- Decide to delete graduating modules from the incubator after
one full cycle.
* - Kilo
- Change policy to delete graduating modules immediately after
the library is released.
.. note:: .. note::
This work is licensed under a Creative Commons Attribution 3.0 This work is licensed under a Creative Commons Attribution 3.0

View File

@ -88,6 +88,17 @@ References
list of volunteers moved to list of volunteers moved to
https://wiki.openstack.org/wiki/CrossProjectLiaisons https://wiki.openstack.org/wiki/CrossProjectLiaisons
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Juno
- Introduced
.. note:: .. note::
This work is licensed under a Creative Commons Attribution 3.0 This work is licensed under a Creative Commons Attribution 3.0

View File

@ -121,6 +121,17 @@ References
.. _Project Creator's Guide: http://docs.openstack.org/infra/manual/creators.html#choosing-a-good-name-for-your-project .. _Project Creator's Guide: http://docs.openstack.org/infra/manual/creators.html#choosing-a-good-name-for-your-project
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Icehouse
- Introduced
.. note:: .. note::

View File

@ -125,6 +125,19 @@ References
.. _documentation for the public APIs of all Oslo libraries: http://docs.openstack.org/developer/openstack-projects .. _documentation for the public APIs of all Oslo libraries: http://docs.openstack.org/developer/openstack-projects
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Icehouse
- Introduced
* - Kilo
- Formalized during the move out of the ``oslo`` namespace package.
.. note:: .. note::

View File

@ -72,6 +72,17 @@ References
N/A N/A
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Juno
- Introduced
.. note:: .. note::

View File

@ -248,6 +248,17 @@ References
* http://lists.openstack.org/pipermail/openstack-dev/2014-June/037159.html * http://lists.openstack.org/pipermail/openstack-dev/2014-June/037159.html
* `pbr's modified SemVer`_ * `pbr's modified SemVer`_
Revision History
================
.. list-table:: Revisions
:header-rows: 1
* - Release Name
- Description
* - Juno
- Introduced
.. note:: .. note::