diff -r 291342c08dd6 faq.rst --- a/faq.rst Thu Oct 11 16:38:18 2012 +0300 +++ b/faq.rst Fri Oct 12 07:14:15 2012 -0700 @@ -39,10 +39,18 @@ If the idea is reasonable, someone will suggest posting it as a feature request on the `issue tracker`_. +Oftentimes core developers will differ in opinion and when there +isn't an obvious victor `Status Quo Wins The Stalemate`_ as outlined in +Nick Coughlin's essay. + +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 - +.. _Status Quo Wins The 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 -r 291342c08dd6 index.rst --- a/index.rst Thu Oct 11 16:38:18 2012 +0300 +++ b/index.rst Fri Oct 12 07:14:15 2012 -0700 @@ -147,14 +147,11 @@ .. _resources: -Resources +Additional 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) * `Issue tracker`_ * `Meta tracker `_ (issue tracker for the issue tracker) @@ -169,11 +166,6 @@ * :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` @@ -190,3 +182,15 @@ .. _IronPython: http://ironpython.net/ .. _Stackless: http://www.stackless.com/ .. _Issue tracker: http://bugs.python.org/ + +Essential Reading +----------------- + +* Coding style guides + * :PEP:`7` (Style Guide for C Code) + * :PEP:`8` (Style Guide for Python Code) +* Help with ... + * :doc:`grammar` + * :doc:`compiler` +* PEPs_ (Python Enhancement Proposals) +* :doc:`faq`