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:
169
169
170
170
3. Wait for the warning to appear in at least two minor Python
171
171
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).
176
177
177
178
- If the expected maintenance overhead and security risk of the
178
179
deprecated behavior is small (e.g. an old function is reimplemented
You can’t perform that action at this time.
0 commit comments