@@ -29,22 +29,17 @@ depending on the PEP's status:
29
29
30
30
* **Rejected **, **Deferred **, **Withdrawn ** and **Superceded ** PEPs should
31
31
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
34
33
with major updates, but it is often better to just propose a new one.
35
34
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.
39
37
40
38
* **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.
43
40
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.
48
43
49
44
* **Active ** PEPs can and should be updated whenever the information described
50
45
changes. Substantive changes to governance PEPs should be reviewed by the
@@ -53,8 +48,7 @@ depending on the PEP's status:
53
48
and are subject to any further conditions stated in the PEP itself.
54
49
55
50
* **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.
58
52
Copyediting, formatting and proofreading can be opened here as pull requests,
59
53
while more substantive content changes should generally be first proposed
60
54
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,
64
58
we generally advise against PRs that simply mass-correct minor typos
65
59
that don't significantly impair meaning and understanding.
66
60
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.
69
62
For example, you could contact the PEP author(s),
70
63
propose your idea in a discussion venue appropriate to the PEP (e.g.
71
64
`
Typing-SIG <
https://mail.python.org/archives/list/[email protected] / >`__
0 commit comments