[Python-checkins] devguide: Close #13440 by linking to a couple of blog posts from the dev FAQ. Also

[nick.coghlan]

http://hg.python.org/devguide/rev/ec52e044421d
changeset:   558:ec52e044421d
user:        Nick Coghlan <ncoghlan at gmail.com>
date:        Fri Oct 19 22:03:15 2012 +1000
summary:
  Close #13440 by linking to a couple of blog posts from the dev FAQ. Also rearrange the main page a bit to address some other concerns that came up on the tracker issue

files:
  faq.rst   |  15 +++++++++++++--
  index.rst |  27 ++++++++++++++++-----------
  2 files changed, 29 insertions(+), 13 deletions(-)


diff --git a/faq.rst b/faq.rst
--- a/faq.rst
+++ b/faq.rst
@@ -25,6 +25,7 @@
 .. _StackOverflow: http://stackoverflow.com/
 .. _Freenode: http://freenode.net/
 
+.. _suggesting-changes:
 
 Where should I suggest new features and language changes?
 ---------------------------------------------------------
@@ -37,12 +38,22 @@
 task.
 
 If the idea is reasonable, someone will suggest posting it as a feature
-request on the `issue tracker`_.
+request on the `issue tracker`_, or, for larger changes, writing it up as
+a `draft PEP`_.
+
+Sometimes core developers will differ in opinion, or merely be collectively
+unconvinced. When there isn't an obvious victor then the
+`Status Quo Wins a Stalemate`_ as outlined in the linked post.
+
+For some examples on language changes that were accepted please read
+`Justifying Python Language Changes`_.
 
 .. _python-ideas: http://mail.python.org/mailman/listinfo/python-ideas
 .. _issue tracker: http://bugs.python.org
 .. _PEP Index: http://www.python.org/dev/peps
-
+.. _draft PEP: http://www.python.org/dev/peps/pep-0001/
+.. _Status Quo Wins a Stalemate: http://www.boredomandlaziness.org/2011/02/status-quo-wins-stalemate.html
+.. _Justifying Python Language Changes: http://www.boredomandlaziness.org/2011/02/justifying-python-language-changes.html
 
 Where should I ask general questions about contributing to CPython?
 -------------------------------------------------------------------
diff --git a/index.rst b/index.rst
--- a/index.rst
+++ b/index.rst
@@ -120,6 +120,7 @@
 * :doc:`stdlibchanges`
 * :doc:`langchanges`
 
+Also refer to :ref:`suggesting-changes` in the FAQ.
 
 Other Interpreter Implementations
 ---------------------------------
@@ -146,12 +147,9 @@
 
 .. _resources:
 
+Key Resources
+-------------
 
-Resources
----------
-
-* Anyone can clone the sources for this guide.  See
-  :ref:`helping-with-the-developers-guide`.
 * Coding style guides
     * :PEP:`7` (Style Guide for C Code)
     * :PEP:`8` (Style Guide for Python Code)
@@ -165,17 +163,23 @@
     * `Browse online <http://hg.python.org/cpython/file/default/>`_
     * `Snapshot of py3k <http://hg.python.org/cpython/archive/default.tar.bz2>`_
     * `Daily OS X installer <http://buildbot.python.org/daily-dmg/>`_
+* PEPs_ (Python Enhancement Proposals)
+* :doc:`faq`
+* :doc:`developers`
+
+Additional Resources
+--------------------
+
+* Anyone can clone the sources for this guide.  See
+  :ref:`helping-with-the-developers-guide`.
+* Help with ...
+    * :doc:`grammar`
+    * :doc:`compiler`
 * Tool support
     * :doc:`emacs`
     * :doc:`gdb`
     * Various tools with configuration files as found in the `Misc directory`_
-* Help with ...
-    * :doc:`grammar`
-    * :doc:`compiler`
-* :doc:`faq`
-* PEPs_ (Python Enhancement Proposals)
 * `python.org maintenance`_
-* :doc:`developers`
 
 * :ref:`Search this guide <search>`
 
@@ -190,3 +194,4 @@
 .. _IronPython: http://ironpython.net/
 .. _Stackless: http://www.stackless.com/
 .. _Issue tracker: http://bugs.python.org/
+

-- 
Repository URL: http://hg.python.org/devguide