[Python-checkins] devguide: Add additional links regarding the PEP process.
chris.jerdonek
python-checkins at python.org
Thu Nov 29 03:13:05 CET 2012
http://hg.python.org/devguide/rev/70fb48c58536
changeset: 575:70fb48c58536
user: Chris Jerdonek <chris.jerdonek at gmail.com>
date: Wed Nov 28 18:12:06 2012 -0800
summary:
Add additional links regarding the PEP process.
files:
faq.rst | 6 ++++++
langchanges.rst | 15 ++++++++++-----
2 files changed, 16 insertions(+), 5 deletions(-)
diff --git a/faq.rst b/faq.rst
--- a/faq.rst
+++ b/faq.rst
@@ -25,6 +25,10 @@
.. _StackOverflow: http://stackoverflow.com/
.. _Freenode: http://freenode.net/
+
+.. index::
+ single: PEP process; in FAQ
+
.. _suggesting-changes:
Where should I suggest new features and language changes?
@@ -48,6 +52,8 @@
For some examples on language changes that were accepted please read
`Justifying Python Language Changes`_.
+See also the :ref:`langchanges` section of this guide.
+
.. _python-ideas: http://mail.python.org/mailman/listinfo/python-ideas
.. _issue tracker: http://bugs.python.org
.. _PEP Index: http://www.python.org/dev/peps
diff --git a/langchanges.rst b/langchanges.rst
--- a/langchanges.rst
+++ b/langchanges.rst
@@ -25,7 +25,7 @@
is to ask on :ref:`python-list or python-ideas <communication>`. You can also
go through Python's stdlib and find examples of code which would benefit from
your proposed change (which helps communicate the usefulness of your change to
-others).
+others). For further guidance, see :ref:`suggesting-changes` in the FAQ.
Your proposed change also needs to be *Pythonic*. While Guido is the only
person who can truly classify something as Pythonic, you can read the `Zen of
@@ -34,11 +34,14 @@
.. _Zen of Python: http://www.python.org/dev/peps/pep-0020/
-Process
--------
+.. index:: PEP process
+
+PEP Process
+-----------
Once you are certain you have a language change proposal which will appeal to
-the general Python community, you can being the process of officially proposing
-the change.
+the general Python community, you can begin the process of officially proposing
+the change. This process is the Python Enhancement Proposal (PEP) process.
+`PEP 1`_ describes it in detail.
You will first need a PEP that you will present to python-ideas. You may be a
little hazy on the technical details as various core developers can help with
@@ -58,3 +61,5 @@
language change will be introduced in the next release of Python. Otherwise
your PEP will be recorded as rejected along with an explanation as to why so
that others do not propose the same language change in the future.
+
+.. _PEP 1: http://www.python.org/dev/peps/pep-0001/
--
Repository URL: http://hg.python.org/devguide
More information about the Python-checkins
mailing list