Skip to content

Commit aa6c83a

Browse files
committed
Meta: Reduce verbosity and perscriptiveness of changes section in CG
1 parent 138b3a2 commit aa6c83a

File tree

1 file changed

+8
-15
lines changed

1 file changed

+8
-15
lines changed

CONTRIBUTING.rst

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -29,22 +29,17 @@ depending on the PEP's status:
2929

3030
* **Rejected**, **Deferred**, **Withdrawn** and **Superceded** PEPs should
3131
usually only be modified when necessary to correct technical issues with
32-
header processing or that prevent content from rendering as originally
33-
intended. Occasionally, a Deferred or even Withdrawn PEP may be resurrected
32+
the syntax. Occasionally, a Deferred or even Withdrawn PEP may be resurrected
3433
with major updates, but it is often better to just propose a new one.
3534

36-
* **Final** PEPs are considered complete; while small fixes to clearly
37-
unintentional errors in the document that meaningfully impair understanding
38-
may be considered, substantive changes to the content generally will not.
35+
* **Final** PEPs are considered complete, though small fixes to unintentional
36+
errors in the document that impair understanding may be accepted.
3937

4038
* **Accepted** PEPs may be updated to reflect minor details of the final
41-
implementation, but significant changes to the normative specification
42-
should be avoided.
39+
implementation, but changes to the specification should be avoided.
4340

44-
* **Provisional** PEPs can be incrementally modified if needed, though
45-
major rewrites and compatibility breakage are discouraged unless absolutely
46-
necessary and any changes should be preceded by discussion and general
47-
consensus among the authors and the relevant community.
41+
* **Provisional** PEPs can be incrementally modified if needed, though rewrites
42+
and compatibility breakage are discouraged unless absolutely necessary.
4843

4944
* **Active** PEPs can and should be updated whenever the information described
5045
changes. Substantive changes to governance PEPs should be reviewed by the
@@ -53,8 +48,7 @@ depending on the PEP's status:
5348
and are subject to any further conditions stated in the PEP itself.
5449

5550
* **Draft** PEPs are freely open for discussion and proposed modification
56-
(though once submitted to the Steering Council or PEP-Delegate for final
57-
review and resolution, significant alterations should be avoided).
51+
until submitted to the Steering Council or PEP-Delegate.
5852
Copyediting, formatting and proofreading can be opened here as pull requests,
5953
while more substantive content changes should generally be first proposed
6054
on the PEP's discussion thread listed in its ``Discussions-To`` header.
@@ -64,8 +58,7 @@ copyediting and proofreading of draft and active PEPs is encouraged,
6458
we generally advise against PRs that simply mass-correct minor typos
6559
that don't significantly impair meaning and understanding.
6660

67-
If you're unsure, in addition to the general guidance above,
68-
we encourage you to reach out first before opening a PR here.
61+
If you're unsure, we encourage you to reach out first before opening a PR here.
6962
For example, you could contact the PEP author(s),
7063
propose your idea in a discussion venue appropriate to the PEP (e.g.
7164
`Typing-SIG <https://mail.python.org/archives/list/[email protected]/>`__

0 commit comments

Comments
 (0)