8000 PEP 1: Clarify that reST is the default & no plaintext PEPs remain · python/peps@51cf8cb · GitHub
[go: up one dir, main page]

Skip to content

Commit 51cf8cb

Browse files
committed
PEP 1: Clarify that reST is the default & no plaintext PEPs remain
1 parent 64de899 commit 51cf8cb

File tree

2 files changed

+7
-8
lines changed

2 files changed

+7
-8
lines changed

pep-0001.txt

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -205,8 +205,8 @@ The standard PEP workflow is:
205205
* The title accurately describes the content.
206206
* The PEP's language (spelling, grammar, sentence structure, etc.)
207207
and code style (examples should match :pep:`7` & :pep:`8`) should be
208-
correct and conformant. The PEP text will be automatically checked for
209-
correct reStructuredText formatting when the pull request is submitted.
208+
correct and conformant. The PEP text will be automatically checked for
209+
correct reStructuredText formatting when the pull request is submitted.
210210
PEPs with invalid reST markup will not be approved.
211211

212212
Editors are generally quite lenient about this initial review,
@@ -547,7 +547,7 @@ optional and are described below. All other headers are required.
547547
Status: <Draft | Active | Accepted | Provisional | Deferred | Rejected |
548548
Withdrawn | Final | Superseded>
549549
Type: <Standards Track | Informational | Process>
550-
* Content-Type: <text/x-rst | text/plain>
550+
* Content-Type: text/x-rst
551551
* Requires: <pep numbers>
552552
Created: <date created on, in dd-mmm-yyyy format>
553553
* Python-Version: <version number>
@@ -603,11 +603,9 @@ The Type header specifies the type of PEP: Standards Track,
603603
Informational, or Process.
604604

605605
The format of a PEP is specified with a Content-Type header.
606-
Valid values are ``text/plain`` for plaintext PEPs (see :pep:`9`)
607-
and ``text/x-rst`` for reStructuredText PEPs (see :pep:`12`).
608-
All new and active PEPs must use reStructuredText, but for backwards
609-
compatibility, plain text is currently still the default if no
610-
Content-Type header is present.
606+
All PEPs must use reStructuredText (see :pep:`12`),
607+
and have a value of ``text/x-rst``, the default.
608+
Previously, plaintext PEPs used ``text/plain`` (see :pep:`9`).
611609

612610
The Created header records the date that the PEP was assigned a
613611
number, while Post-History is used to record the dates of when new

pep-0012/pep-NNNN.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ PEP-Delegate: <PEP delegate's real name>
66
Discussions-To: <email address or URL>
77
Status: <REQUIRED: Draft | Active | Accepted | Provisional | Deferred | Rejected | Withdrawn | Final | Superseded>
88
Type: <REQUIRED: Standards Track | Informational | Process>
9+
Content-Type: text/x-rst
910
Requires: <pep numbers>
1011
Created: <date created on, in dd-mmm-yyyy format>
1112
Python-Version: <version number>

0 commit comments

Comments
 (0)
0