diff options
author | Jay Faulkner <jay@jvf.cc> | 2023-01-23 13:01:08 -0800 |
---|---|---|
committer | Jay Faulkner <jay@jvf.cc> | 2023-01-24 16:13:34 +0000 |
commit | 38777e5030d17320fa284fd30f7423e19c55d0ac (patch) | |
tree | c8d286dec3a1ed266aef31c980486f30aceac0f5 | |
parent | 2e1477f4335e949bd593d0d56d32652eac564626 (diff) | |
download | ironic-38777e5030d17320fa284fd30f7423e19c55d0ac.tar.gz |
Clarify release docs: bugfix releases optional
Bugfix releases are optional in practice; document that truth in
our release documents.
Change-Id: Ie24e959fdb338fafeafdf0e064eede273f2011f4
-rw-r--r-- | doc/source/contributor/releasing.rst | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/source/contributor/releasing.rst b/doc/source/contributor/releasing.rst index eab0649c6..3c0732c5b 100644 --- a/doc/source/contributor/releasing.rst +++ b/doc/source/contributor/releasing.rst @@ -125,19 +125,23 @@ openstack ``stable/NAME`` branches: * ironic-inspector * ironic-python-agent -They are also released on a regular cadence as opposed to on-demand, namely -three times a release cycle (roughly a release every 2 months). One of the -releases corresponds to the coordinated OpenStack released and receives a -``stable/NAME`` branch. The other two happen during the cycle and receive a -``bugfix/X.Y`` branch, where ``X.Y`` consists of the major and the minor -component of the version (e.g. ``bugfix/8.1`` for 8.1.0). +These projects receive releases every six months as part of the coordinated +OpenStack release that happens semi-annually. These releases can be +found in a ``stable/NAME`` branch. + +They are also evaluated for additional bugfix releases between scheduled +stable releases at the two and four month milestore between stable releases +(roughly every 2 months). These releases can be found in a ``bugfix/X.Y`` +branch. A bugfix release is only created if there are significant +beneficial changes and a known downstream operator or distributor will consume +the release. To leave some version space for releases from these branches, releases of these projects from the master branch always increase either the major or the minor version. -Currently releases from bugfix branches cannot be automated and must be done by -the release team manually. +Currently releases and retirements from bugfix branches cannot be automated and +must be done by the release team manually. After the creation of a bugfix branch it is utmost important to update the upper-constraints link for the tests in the tox.ini file, plus override the |