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.