[Python-checkins] devguide: Add a doc listing the various places Python's development is discussed.

[brett.cannon]

brett.cannon pushed bc01a9d81b11 to devguide:

http://hg.python.org/devguide/rev/bc01a9d81b11
changeset:   75:bc01a9d81b11
user:        Brett Cannon <brett at python.org>
date:        Mon Jan 10 12:14:27 2011 -0800
summary:
  Add a doc listing the various places Python's development is discussed.

files:
  communication.rst
  index.rst

diff --git a/communication.rst b/communication.rst
new file mode 100644
--- /dev/null
+++ b/communication.rst
@@ -0,0 +1,70 @@
+.. _communication:
+
+Following Python's Development
+==============================
+
+Python's development is communicated through a myriad of ways, mostly through
+mailing lists, but also other forms.
+
+Mailing Lists
+-------------
+
+The primary mailing list where discussions about Python's development occur is
+python-dev_. The list is open to the public and is subscribed to by all core
+developers plus many people simply interested in following Python's
+development. Discussion is focused on issues related to Python's development,
+such as how to handle a specific issue, a PEP, etc. Ideas about new
+functionality should **not** start here and instead should be sent to
+python-ideas_. Technical support questions should also not be asked here and
+instead should go to comp.lang.python_ or python-help_.
+
+The python-committers_ mailing list is publicly archived but only open to core
+developers to subscribe to. If something only affect core developers (e.g., the
+tree is frozen for commits, etc.), it is discussed here instead of python-dev
+to keep traffic down on the latter.
+
+Python-ideas_ is a mailing list open to the public to discuss ideas on changing
+Python. If a new idea does not start here (or comp.lang.python_), it will get
+redirected here.
+
+Python-checkins_ sends out an email for every commit to Python's various
+repositories (both svn.python.org and hg.python.org). All core developers
+subscribe to this list and are known to reply to these emails to make comments
+about various issues they catch in the commit. Replies get redirected to
+python-dev.
+
+There are two mailing lists related to issues on the `issue tracker`_. If you
+only want an email for when a new issue is open, subscribe to
+new-bugs-announce_. If you would rather receive an email for all changes made
+to any issue, subscribe to python-bugs-list_.
+
+A complete list of Python mailing lists can be found at http://mail.python.org.
+
+.. _issue tracker: http://bugs.python.org
+.. _new-bugs-announce: http://mail.python.org/mailman/listinfo/new-bugs-announce
+.. _python-bugs-list: http://mail.python.org/mailman/listinfo/python-bugs-list
+.. _python-checkins: http://mail.python.org/mailman/listinfo/python-checkins
+.. _python-committers: http://mail.python.org/mailman/listinfo/python-committers
+.. _python-dev: http://mail.python.org/mailman/listinfo/python-dev
+.. _python-help: http://mail.python.org/mailman/listinfo/python-help
+.. _python-ideas: http://mail.python.org/mailman/listinfo/python-ideas
+
+
+Newsgroups
+----------
+
+The newsgroup most closely related to Python's development is
+comp.lang.python_ (also available as a mailing list through python-list).
+Sometimes new ideas for Python start here to gather community opinion before
+heading to python-ideas_.
+
+.. _comp.lang.python: http://mail.python.org/mailman/listinfo/python-list
+
+
+IRC
+---
+
+Some core developers enjoy spending time on IRC discussing various issues
+regarding Python's development in the #python-dev channel. This is not a place
+to ask for help with Python, but to discuss issues related to Python's own
+development.
diff --git a/index.rst b/index.rst
--- a/index.rst
+++ b/index.rst
@@ -14,6 +14,7 @@
    triage
    devrole
    languishing
+   communication
 
 
 .. todolist::
@@ -44,7 +45,7 @@
     * :ref:`triage`
 * :ref:`devrole`
     * :ref:`languishing`
-* `Following Python's development <XXX>`_
+* :ref:`communication`
 * `Gaining commit privileges <XXX>`_
     * `Committing patches <XXX>`_
 

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