Skip to content

Commit c5d1b7c

Browse files
JacobCoffeeAA-Turnerhugovk
authored
Note when to backport changes (python#1169)
Co-authored-by: Adam Turner <[email protected]> Co-authored-by: Hugo van Kemenade <[email protected]>
1 parent e6b4ed1 commit c5d1b7c

File tree

2 files changed

+8
-2
lines changed

2 files changed

+8
-2
lines changed

developer-workflow/development-cycle.rst

+7-1
Original file line numberDiff line numberDiff line change
@@ -77,11 +77,17 @@ releases; the terms are used interchangeably. These releases have a
7777
**micro version** number greater than zero.
7878

7979
The only changes allowed to occur in a maintenance branch without debate are
80-
bug fixes. Also, a general rule for maintenance branches is that compatibility
80+
bug fixes, test improvements, and edits to the documentation.
81+
Also, a general rule for maintenance branches is that compatibility
8182
must not be broken at any point between sibling micro releases (3.5.1, 3.5.2,
8283
etc.). For both rules, only rare exceptions are accepted and **must** be
8384
discussed first.
8485

86+
Backporting changes reduces the risk of future conflicts.
87+
For documentation, it increases the visibility of improvements,
88+
since most readers access the `stable documentation <https://docs.python.org/3/>`__
89+
rather than the `development documentation <https://docs.python.org/dev/>`__.
90+
8591
A new maintenance branch is normally created when the next feature release
8692
cycle reaches feature freeze, i.e. at its first beta pre-release.
8793
From that point on, changes intended for remaining pre-releases, the final

versions.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Status key
5050
but new source-only versions can be released
5151
:end-of-life: release cycle is frozen; no further changes can be pushed to it.
5252

53-
See also the :ref:`devcycle` page for more information about branches.
53+
See also the :ref:`devcycle` page for more information about branches and backporting.
5454

5555
By default, the end-of-life is scheduled 5 years after the first release,
5656
but can be adjusted by the release manager of each branch. All Python 2

0 commit comments

Comments
 (0)