File tree Expand file tree Collapse file tree 1 file changed +5
-4
lines changed
Expand file tree Collapse file tree 1 file changed +5
-4
lines changed Original file line number Diff line number Diff line change @@ -169,10 +169,11 @@ several releases:
169169
1701703. 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
You can’t perform that action at this time.
0 commit comments