Skip to content

Commit

Permalink
Update mailing list information following retirement of python-dev (#…
Browse files Browse the repository at this point in the history
…1249)

Signed-off-by: Abhishek Kumar <abhishek22512@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
  • Loading branch information
octonawish-akcodes and AA-Turner authored Feb 3, 2025
1 parent b8b92a5 commit d0899f7
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 42 deletions.
4 changes: 2 additions & 2 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ Due to the fact that this project is entirely volunteer-run (that is, no one is
to work on Python full-time), we unfortunately can make no guarantees as to if
or when a core developer will get around to reviewing your pull request.
If no core developer has done a review or responded to changes made because of a
"changes requested" review, please feel free to email [python-dev](https://mail.python.org/mailman3/lists/python-dev.python.org/) to ask if
someone could take a look at your pull request.
"changes requested" review, please consider seeking assistance through the
[Core Development Discourse category](https://discuss.python.org/c/core-dev/23).


## Code of Conduct
Expand Down
38 changes: 17 additions & 21 deletions developer-workflow/communication-channels.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,13 @@ in return.
Mailing lists
=============

.. note:: Some mailing lists have been supplanted by categories in the
Python `Discourse`_. Specifically,
.. note::

Mailing lists have generally been replaced by the `Discourse`_ forum.
Specifically,

* The python-dev list is superseded by the `Core Development`_
and `PEPs`_ categories on Discourse.

* The python-ideas list is superseded by posts in the `Ideas`_
category on Discourse.

Expand All @@ -42,17 +43,21 @@ Mailing lists
- Ideas about new functionality should **not** start here, and instead
should be discussed in `Ideas`_.
- Technical support questions should also not be asked here, and instead
should go to the python-list_ or python-help_ mailing lists, or the
`Python Help`_ category on Discourse.
should go to the `Python Help`_ category on Discourse or the python-list_.

Existing threads on the python-dev_, python-committers_, and python-ideas_ mailing lists
can be accessed through the `online archive <web gateway_>`__.
Previous threads on the python-dev_, python-committers_, and python-ideas_
mailing lists can be accessed through the `online archive
<https://mail.python.org/archives/>`__.

.. _python-committers: https://mail.python.org/mailman3/lists/python-committers.python.org/
.. _python-dev: https://mail.python.org/mailman3/lists/python-dev.python.org/
.. _python-ideas: https://mail.python.org/mailman3/lists/python-ideas.python.org

General Python questions should go to `python-list`_ or `tutor`_
or similar resources, such as StackOverflow_ or the ``#python`` IRC channel
or similar resources, such as `Stack Overflow`_ or the ``#python`` IRC channel
on Libera.Chat_.

`The core-workflow <https://github.com/python/core-workflow/issues>`_
The `core-workflow <https://github.com/python/core-workflow/issues>`__
issue tracker is the place to discuss and work on improvements to the CPython
core development workflow.

Expand All @@ -62,28 +67,19 @@ https://mail.python.org/mailman3/ (newer lists, using Mailman3). Some lists may
be mirrored at `GMANE <https://gmane.io/>`_ and can be read and posted to in various
ways, including via web browsers, NNTP newsreaders, and RSS feed readers.

.. _issue tracker: https://github.com/python/cpython/issues
.. _python-committers: https://mail.python.org/mailman3/lists/python-committers.python.org/
.. _python-dev: https://mail.python.org/mailman3/lists/python-dev.python.org/
.. _python-help: https://mail.python.org/mailman/listinfo/python-help
.. _python-ideas: https://mail.python.org/mailman3/lists/python-ideas.python.org
.. _python-list: https://mail.python.org/mailman/listinfo/python-list
.. _tutor: https://mail.python.org/mailman/listinfo/tutor
.. _StackOverflow: https://stackoverflow.com/
.. _Stack Overflow: https://stackoverflow.com/
.. _Libera.Chat: https://libera.chat/
.. _web gateway: https://mail.python.org/archives/


.. _communication-discourse:

Discourse (discuss.python.org web forum)
========================================

We have our own `Discourse`_ forum for both developers and users. This forum
complements the `python-dev`_, `python-ideas`_, `python-help`_, and
`python-list`_ mailing lists.

This forum has different categories and most core development discussions
We have our own `Discourse`_ forum for both developers and users.
It has different categories and most core development discussions
take place in the open forum categories for `PEPs`_ and `Core Development`_
(these are the Discourse equivalents to the python-dev mailing list).
All categories are open for users to read and post with the exception of
Expand Down
19 changes: 0 additions & 19 deletions getting-started/getting-help.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,25 +37,6 @@ Those particularly relevant for help contributing to Python itself include:
.. _Ideas: https://discuss.python.org/c/ideas/6


.. _help-mailing-lists:

Mailing lists
-------------

Further options for seeking assistance include the
`python-ideas`_ and `python-dev`_ mailing lists,
which correspond to the `Ideas`_ and `Core Development`_
:ref:`help-discourse` categories, respectively.
The Discourse categories are generally more active
and are the preferred venue for new discussions,
but the mailing lists are still monitored and responded to.
These mailing lists are for questions involving the
development *of* Python, **not** for development *with* Python.

.. _python-ideas: https://mail.python.org/mailman3/lists/python-ideas.python.org
.. _python-dev: https://mail.python.org/mailman3/lists/python-dev.python.org/


Ask #python-dev
---------------

Expand Down

0 comments on commit d0899f7

Please sign in to comment.