openstack/governance
Code Issues Proposed changes

Revert "Revert "Add guidelines about naming versions of the OpenStack projects""

Browse Source 
This was reverted under the understanding it was a fast-track change; it was not and therefore needs a separate formal-vote to change.

This reverts commit fdc25d3ceb.

Change-Id: Ibe5e4474f8e34c4d000c8e2576e685441beecad0
This commit is contained in:
Jay Faulkner 2023-02-20 08:56:13 -08:00
parent fdc25d3ceb
commit 723167429d
1 changed files with 49 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
reference/release-naming.rst
View File

@ -39,10 +39,59 @@ in some places.
* Testing tools: Use release number which is more aligned with what stable
branches are going to use.
* Release notes: For the version of specific project use combined OpenStack release and
the project's version, like "OpenStack 2023.1 (Nova 27.X.Y)".
There should not be OpenStack release name, like "Antelope" included in the version.
Examples:
* OpenStack 2023.1 (Nova 27.0.0)
* OpenStack 2023.2 (Neutron 23.0.0)
In case when there is no need to give version of the specific project, but
just version of OpenStack, there should be only version number used, like
"OpenStack 2023.1".
Examples:
* OpenStack 2023.2
* OpenStack 2024.1
* Project specific documentation: use release name combined with version of the project.
Examples:
* OpenStack 2023.1 (Nova 27.0.0)
* OpenStack 2023.2 (Neutron 23.0.0)
* OpenStack documentation: in cases when there is need to just give version of OpenStack
without specific project's version, use version number without marketing name.
Examples:
* OpenStack 2023.2
* OpenStack 2024.1
* Release page/tooling/milestone name: The release team can choose either to
continue using the release name or use number for release tooling and
milestone name.
* Marketing materials: Release name is still there to be used in any marketing or
other non-technical materials. Version number can be also used in such cases.
* Other, non-marketing related places: use release name combined with version of
the project unless there is clear reason to use OpenStack release name instead.
Examples:
* OpenStack 2023.1 (Nova 27.0.0)
* OpenStack 2023.2 (Neutron 23.0.0)
Or if there is no specific project version needed:
* OpenStack 2023.2
* OpenStack 2024.1
Release Name
------------