From 1ee67bcac387294be8eb7dd7de2cc24f2d4905af Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Date: Tue, 6 Jan 2026 11:48:03 +0200 Subject: [PATCH 1/3] PEP 387: Update language around discussion venues, part 2 --- peps/pep-0387.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/peps/pep-0387.rst b/peps/pep-0387.rst index 775b551ab57..1fa00847823 100644 --- a/peps/pep-0387.rst +++ b/peps/pep-0387.rst @@ -146,8 +146,13 @@ Making Incompatible Changes Making an incompatible change is a gradual process performed over several releases: -1. :pep:`PEP 1: Start with an idea <1#start-with-an-idea-for-python>` discussion. - If the discussion reaches consensus that acceptance is possible a PEP or +1. Discuss the change. + Depending on the degree of incompatibility, this could be on + `Discourse `__, + the `issue tracker `__, + or the appropriate workgroup or SIG. + If the discussion reaches consensus a + :pep:`PEP <1#start-with-an-idea-for-python>` or similar document may be written. Hopefully users of the affected API will pipe up to comment. From a7359f927677f24c79c5d374356c1f67128cc932 Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Date: Tue, 6 Jan 2026 13:29:51 +0200 Subject: [PATCH 2/3] PEP 387: Link to PEP 1 rather than a section --- peps/pep-0387.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/peps/pep-0387.rst b/peps/pep-0387.rst index 1fa00847823..de81a5002e7 100644 --- a/peps/pep-0387.rst +++ b/peps/pep-0387.rst @@ -151,8 +151,7 @@ several releases: `Discourse `__, the `issue tracker `__, or the appropriate workgroup or SIG. - If the discussion reaches consensus a - :pep:`PEP <1#start-with-an-idea-for-python>` or + If the discussion reaches consensus a :pep:`PEP <1>` or similar document may be written. Hopefully users of the affected API will pipe up to comment. From 0e73ec0a1e318fcd2a38996182d9e6351548f8ce Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Date: Tue, 6 Jan 2026 20:03:59 +0200 Subject: [PATCH 3/3] Improve wording Co-authored-by: Cody Maloney --- peps/pep-0387.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/peps/pep-0387.rst b/peps/pep-0387.rst index de81a5002e7..2b6f1391f55 100644 --- a/peps/pep-0387.rst +++ b/peps/pep-0387.rst @@ -150,7 +150,7 @@ several releases: Depending on the degree of incompatibility, this could be on `Discourse `__, the `issue tracker `__, - or the appropriate workgroup or SIG. + or in an appropriate workgroup or SIG. If the discussion reaches consensus a :pep:`PEP <1>` or similar document may be written. Hopefully users of the affected API will pipe up to comment.