Skip to content

Commit 583f4c5

Browse files
committed
Add more explanation to the Python versions Status key
1 parent df95f8f commit 583f4c5

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

versions.rst

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,24 @@ Full chart
5151
Status key
5252
==========
5353

54-
:feature: new features, bugfixes, and security fixes are accepted.
55-
:prerelease: feature fixes, bugfixes, and security fixes are accepted for the
56-
upcoming feature release.
57-
:bugfix: bugfixes and security fixes are accepted, new binaries are still
58-
released. (Also called **maintenance** mode or **stable** release)
59-
:security: only security fixes are accepted and no more binaries are released,
60-
but new source-only versions can be released
61-
:end-of-life: release cycle is frozen; no further changes can be pushed to it.
54+
Python releases go through five phases:
55+
56+
:feature: Before the first beta, the next full release can accept new features,
57+
bug fixes, and security fixes.
58+
59+
:prerelease: After the first beta, no new features can go in, but feature
60+
fixes, bug fixes, and security fixes are accepted for the upcoming feature
61+
release.
62+
63+
:bugfix: Once a version has been released, bug fixes and security fixes are
64+
accepted. New binaries are built and released. (Also called **maintenance**
65+
mode or **stable** release)
66+
67+
:security: After two years, only security fixes are accepted and no more
68+
binaries are released. New source-only versions can be released as needed.
69+
70+
:end-of-life: Five years after a release, support ends. The release cycle is
71+
frozen; no further changes can be pushed to it.
6272

6373
See also the :ref:`devcycle` page for more information about branches and backporting.
6474

0 commit comments

Comments
 (0)