Commits

Nick Coghlan committed ec52e04 Draft

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

Comments (0)

Files changed (2)

 .. _StackOverflow: http://stackoverflow.com/
 .. _Freenode: http://freenode.net/
 
+.. _suggesting-changes:
 
 Where should I suggest new features and language changes?
 ---------------------------------------------------------
 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?
 -------------------------------------------------------------------
 * :doc:`stdlibchanges`
 * :doc:`langchanges`
 
+Also refer to :ref:`suggesting-changes` in the FAQ.
 
 Other Interpreter Implementations
 ---------------------------------
 
 .. _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)
     * `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>`
 
 .. _IronPython: http://ironpython.net/
 .. _Stackless: http://www.stackless.com/
 .. _Issue tracker: http://bugs.python.org/
+