@@ -77,10 +77,21 @@ releases; the terms are used interchangeably. These releases have a
77
77
**micro version ** number greater than zero.
78
78
79
79
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. Also, a general rule for maintenance branches is that compatibility
81
81
must not be broken at any point between sibling micro releases (3.5.1, 3.5.2,
82
- etc.). For both rules, only rare exceptions are accepted and **must ** be
83
- discussed first.
82
+ etc.). For both rules, only rare exceptions are accepted and **must ** be
83
+ discussed first. Among the rare exceptions to the rules of bug fixes and compatibility,
84
+ backporting of documentation and tests is encouraged.
85
+
86
+ Backporting serves dual purposes. First, it increases the visibility of
87
+ documentation changes since most users refer to stable versions at
88
+ `docs.python.org/3/ <https://docs.python.org/3/ >`_ rather
89
+ than the `docs.python.org/dev/ <https://docs.python.org/dev/ >`_ documentation.
90
+ Second, it minimizes conflicts for future bugfix backports.
91
+
92
+ Backporting should target enhancements in documentation and tests for
93
+ currently **stable ** versions, specifically branches in a **bugfix ** release cycle
94
+ or higher.
84
95
85
96
A new maintenance branch is normally created when the next feature release
86
97
cycle reaches feature freeze, i.e. at its first beta pre-release.
0 commit comments