From 307b9cdf8897cbade627733ad6c84fe3fc838d25 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Fri, 16 Apr 2021 15:21:47 -0700 Subject: [PATCH] PEP 387: clarify how long a warning must be emitted before a change can be made --- pep-0387.txt | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/pep-0387.txt b/pep-0387.txt index ed40c99df..031059c1d 100644 --- a/pep-0387.txt +++ b/pep-0387.txt @@ -131,8 +131,11 @@ several releases: incompatibility is expected to become the default and a link to an issue that users can post feedback to. -3. Wait for the warning to appear in at least two major Python - versions. It's fine to wait more than two releases. +3. Wait for the warning to appear in at least two minor Python + versions of the same major version, or one minor version in an older + major version (e.g. for a warning in Python 3.10, you either wait + until at least Python 3.12 or Python 4.0 to make the change). + It's fine to wait more than two releases. 4. See if there's any feedback. Users not involved in the original discussions may comment now after seeing the warning. Perhaps