Skip to content

Commit 013d355

Browse files
committed
don't re-wrap, and avoid two-space
1 parent eae920a commit 013d355

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

developer-workflow/lang-changes.rst

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -20,23 +20,23 @@ Books will need updating, code will be changed, and a new way to do things will
2020
need to be learned. Changes to Python are never taken
2121
lightly.
2222

23-
Backward compatibility is a significant concern. Existing Python code has to
24-
continue to work. There are exceptions to this rule, but they are very rare
23+
Backward compatibility is a significant concern. Existing Python code has to
24+
continue to work. There are exceptions to this rule, but they are very rare
2525
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
2929
beneficial to many Python users. If the change only helps a small percentage of
3030
Python developers then the change will not be made. A good way to see if your
3131
idea would work for a large portion of the Python community is to discuss it in
32-
the `Ideas category in Discourse <ideas_>`_. You can also look in Python's standard
32+
the `Ideas category in Discourse <ideas_>`_. You can also look in Python's standard
3333
library to find examples of code which would benefit from your proposed change.
3434

3535
.. 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.
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.
4040

4141
.. index::
4242
single: PEP process
@@ -75,7 +75,7 @@ Some things you should **not** do:
7575
until the idea has been accepted for further consideration.
7676

7777
- **Don't** create a list of proposed changes. Each idea needs its own
78-
discussion. Proposing a change is significant work. You will need to spend
78+
discussion. Proposing a change is significant work. You will need to spend
7979
time on each proposal. A tossed-off list will not be taken seriously.
8080

8181
When justifying your idea, these are not good reasons to make a change:
@@ -112,7 +112,8 @@ part of the process. Other people's perspectives will help explore the full
112112
impact of the idea and find strengths or weaknesses you may not have
113113
considered.
114114

115-
You will almost always get at least some push-back. Don't be disappointed, and don't take it personally.
115+
You will almost always get at least some push-back. Don't be disappointed,
116+
and don't take it personally.
116117
As the long list of :pep:`Withdrawn and Rejected PEPs
117118
<0#rejected-superseded-and-withdrawn-peps>` in the :pep:`PEP Index <0>`
118119
attests, and as befits a mature programming language, getting significant
@@ -125,7 +126,7 @@ help identify them so you can address them or move on. Keep the discussion
125126
productive and focused on the issues, not on personalities.
126127

127128
It's especially useful to get core team members involved in the discussion.
128-
Sometimes they will differ in opinion, or merely be unconvinced. When there
129+
Sometimes they will differ in opinion, or merely be unconvinced. When there
129130
isn't a clear positive sentiment, the `Status Quo Wins a Stalemate`_.
130131

131132
Even if your idea is not accepted, the discussion can help you and others
@@ -149,12 +150,12 @@ PEP process
149150

150151
Once you are certain you have a language change proposal which will appeal to
151152
the general Python community, you can begin the PEP
152-
process to officially propose the change. See :pep:`1` for
153+
process to officially propose the change. See :pep:`1` for
153154
information on PEPs and the PEP process, and the :pep:`PEP Index <0>` for
154155
examples.
155156

156157
If the PEP is accepted, then your language change will be introduced in a
157-
future release of Python. Otherwise, your PEP will be recorded as rejected
158+
future release of Python. Otherwise, your PEP will be recorded as rejected
158159
along with an explanation, to inform others who may propose a similar language
159160
change in the future.
160161

0 commit comments

Comments
 (0)