Skip to content

Commit 9fa0112

Browse files
committed
more changes from review
1 parent a6aab7a commit 9fa0112

File tree

1 file changed

+22
-25
lines changed

1 file changed

+22
-25
lines changed

developer-workflow/lang-changes.rst

Lines changed: 22 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -26,19 +26,17 @@ and are only allowed when the benefits of the change greatly outweigh the costs
2626
of breaking existing code.
2727

2828
Because of the seriousness of changing the language, any change must be
29-
beneficial to many Python users. If the change only helps a
30-
small percentage of Python developers then the change will not be made. A good
31-
way to see if your idea would work for a large portion of the Python community
32-
is to ask in the `Ideas Discourse category <ideas_>`_. You can also
33-
look in Python's standard library to find examples of code which would benefit from
34-
your proposed change. This can also help communicate the usefulness of your change to
35-
others.
36-
37-
For all of these reasons, most proposed changes to Python are rejected. This
38-
doesn't mean you shouldn't suggest them. It can be useful to explore
39-
alternatives and to get feedback from the community. Just be aware that
40-
getting a change accepted is difficult. Don't take it personally.
41-
29+
beneficial to many Python users. If the change only helps a small percentage of
30+
Python developers then the change will not be made. A good way to see if your
31+
idea would work for a large portion of the Python community is to discuss it in
32+
the `Ideas Discourse category <ideas_>`_. You can also look in Python's standard
33+
library to find examples of code which would benefit from your proposed change.
34+
35+
.. important::
36+
For all of these reasons, most proposed changes to Python are rejected. This
37+
doesn't mean you shouldn't suggest them. It can be useful to explore
38+
alternatives and to get feedback from the community. Just be aware that
39+
getting a change accepted is difficult. Don't take it personally.
4240

4341
.. index::
4442
single: PEP process
@@ -50,7 +48,7 @@ Suggesting new features and language changes
5048

5149
Proposing a change involves the following steps:
5250

53-
- Describe your idea.
51+
- Describe your idea in detail.
5452

5553
- Engage in discussion about the idea.
5654

@@ -148,17 +146,16 @@ as PEP following the :ref:`lang-changes-pep-process`. Congratulations!
148146
PEP process
149147
-----------
150148

151-
Once you are certain you have a language change proposal
152-
which will appeal to the general Python community,
153-
you can begin the :abbr:`PEP (Python enhancement proposal)` process
154-
to officially propose the change.
155-
See :pep:`1` for information on PEPs and the PEP process,
156-
and the :pep:`PEP Index <0>` for examples.
157-
158-
If the PEP is accepted, then your proposed language change will be introduced
159-
in the next release of Python.
160-
Otherwise, your PEP will be recorded as rejected along with an explanation,
161-
to inform others who may propose a similar language change in the future.
149+
Once you are certain you have a language change proposal which will appeal to
150+
the general Python community, you can begin the :abbr:`PEP (Python enhancement
151+
proposal)` process to officially propose the change. See :pep:`1` for
152+
information on PEPs and the PEP process, and the :pep:`PEP Index <0>` for
153+
examples.
154+
155+
If the PEP is accepted, then your language change will be introduced in a
156+
future release of Python. Otherwise, your PEP will be recorded as rejected
157+
along with an explanation, to inform others who may propose a similar language
158+
change in the future.
162159

163160

164161
.. _issue tracker: https://github.com/python/cpython/issues

0 commit comments

Comments
 (0)