[Python-checkins] peps: PEP process changes triggered by the packaging PEPs
nick.coghlan
python-checkins at python.org
Sun Apr 7 10:26:26 CEST 2013
http://hg.python.org/peps/rev/0a8e456973ed
changeset: 4840:0a8e456973ed
user: Nick Coghlan <ncoghlan at gmail.com>
date: Sun Apr 07 18:26:06 2013 +1000
summary:
PEP process changes triggered by the packaging PEPs
- allow a Discussion-To header to indicate the list for pronouncement
- allow version independent Standards track PEPs
files:
pep-0001.txt | 38 +++++++++++++++++++++++++++-----------
1 files changed, 27 insertions(+), 11 deletions(-)
diff --git a/pep-0001.txt b/pep-0001.txt
--- a/pep-0001.txt
+++ b/pep-0001.txt
@@ -7,7 +7,8 @@
Type: Process
Content-Type: text/x-rst
Created: 13-Jun-2000
-Post-History: 21-Mar-2001, 29-Jul-2002, 03-May-2003, 05-May-2012
+Post-History: 21-Mar-2001, 29-Jul-2002, 03-May-2003, 05-May-2012,
+ 07-Apr-2013
What is a PEP?
@@ -36,7 +37,10 @@
There are three kinds of PEP:
1. A **Standards Track** PEP describes a new feature or implementation
- for Python.
+ for Python. It may also describe an interoperability standard that will
+ be supported outside the standard library for current Python versions
+ before a subsequent PEP adds standard library support in a future
+ version.
2. An **Informational** PEP describes a Python design issue, or
provides general guidelines or information to the Python community,
@@ -210,6 +214,12 @@
directly by the BDFL, this will be recorded by including the
"BDFL-Delegate" header in the PEP.
+PEP review and resolution may also occur on a list other than python-dev
+(for example, distutils-sig for packaging related PEPs that don't
+immediately affect the standard library). In this case, the "Discussions-To"
+heading in the PEP will identify the appropriate alternative list where
+discussion, review and pronouncement on the PEP will occur.
+
For a PEP to be accepted it must meet certain minimum criteria. It
must be a clear and complete description of the proposed enhancement.
The enhancement must represent a net improvement. The proposed
@@ -401,12 +411,14 @@
only. It contains a URL that should point to an email message or
other web resource where the pronouncement about the PEP is made.*
-While a PEP is in private discussions (usually during the initial
-Draft phase), a Discussions-To header will indicate the mailing list
-or URL where the PEP is being discussed. No Discussions-To header is
-necessary if the PEP is being discussed privately with the author, or
-on the python-list, python-ideas or python-dev email mailing lists. Note
-that email addresses in the Discussions-To header will not be obscured.
+For a PEP where final pronouncement will be made on a list other than
+python-dev, a Discussions-To header will indicate the mailing list
+or URL where the pronouncement will occur. A temporary Discussions-To header
+may also be used when a draft PEP is being discussed prior to submission for
+pronouncement. No Discussions-To header is necessary if the PEP is being
+discussed privately with the author, or on the python-list, python-ideas
+or python-dev mailing lists. Note that email addresses in the
+Discussions-To header will not be obscured.
The Type header specifies the type of PEP: Standards Track,
Informational, or Process.
@@ -422,9 +434,13 @@
versions of the PEP are posted to python-list and/or python-dev. Both
headers should be in dd-mmm-yyyy format, e.g. 14-Aug-2001.
-Standards Track PEPs must have a Python-Version header which indicates
-the version of Python that the feature will be released with.
-Informational and Process PEPs do not need a Python-Version header.
+Standards Track PEPs will typically have a Python-Version header which
+indicates the version of Python that the feature will be released with.
+Standards Track PEPs without a Python-Version header indicate
+interoperability standards that will initially be supported through
+external libraries and tools, and then supplemented by a later PEP to
+add support to the standard library. Informational and Process PEPs do
+not need a Python-Version header.
PEPs may have a Requires header, indicating the PEP numbers that this
PEP depends on.
--
Repository URL: http://hg.python.org/peps
More information about the Python-checkins
mailing list