Skip to content

Commit 36b3b39

Browse files
authored
PEP 387: Suggest waiting 5 years before removing a deprecated feature (#4156)
1 parent d386fff commit 36b3b39

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

peps/pep-0387.rst

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -169,10 +169,11 @@ several releases:
169169

170170
3. Wait for the warning to appear in at least two minor Python
171171
versions of the same major version, or one minor version in an older
172-
major version (e.g. for a warning in Python 3.10.0, you either wait
173-
until at least Python 3.12 or Python 4.0 to make the change).
174-
175-
It's fine to wait more than two releases, for example:
172+
major version (e.g., for a warning in Python 3.10.0, you either wait
173+
until at least Python 3.12 or Python 4.0 to make the change). It is
174+
preferred, though, to wait 5 years before removal (e.g., warn starting in
175+
Python 3.10, removal in 3.15; this happens to coincide with the current
176+
lifetime of a minor release of Python).
176177

177178
- If the expected maintenance overhead and security risk of the
178179
deprecated behavior is small (e.g. an old function is reimplemented

0 commit comments

Comments
 (0)