Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update mailing list information in devguide #1249

Merged
merged 3 commits into from
Feb 3, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 (i.e. no one is paid
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