@@ -27,12 +27,13 @@ in return.
2727Mailing lists
2828=============
2929
30- .. note :: Some mailing lists have been supplanted by categories in the
31- Python `Discourse `_. Specifically,
30+ .. note ::
31+
32+ Mailing lists have generally been replaced by the `Discourse `_ forum.
33+ Specifically,
3234
3335 * The python-dev list is superseded by the `Core Development `_
3436 and `PEPs `_ categories on Discourse.
35-
3637 * The python-ideas list is superseded by posts in the `Ideas `_
3738 category on Discourse.
3839
@@ -42,17 +43,21 @@ Mailing lists
4243 - Ideas about new functionality should **not ** start here, and instead
4344 should be discussed in `Ideas `_.
4445 - Technical support questions should also not be asked here, and instead
45- should go to the python-list _ or python-help _ mailing lists, or the
46- `Python Help `_ category on Discourse.
46+ should go to the `Python Help `_ category on Discourse or the python-list _.
4747
48- Existing threads on the python-dev _, python-committers _, and python-ideas _ mailing lists
49- can be accessed through the `online archive <web gateway _>`__.
48+ Previous threads on the python-dev _, python-committers _, and python-ideas _
49+ mailing lists can be accessed through the `online archive
50+ <https://mail.python.org/archives/> `__.
51+
52+ .. _python-committers : https://mail.python.org/mailman3/lists/python-committers.python.org/
53+ .. _python-dev : https://mail.python.org/mailman3/lists/python-dev.python.org/
54+ .. _python-ideas : https://mail.python.org/mailman3/lists/python-ideas.python.org
5055
5156General Python questions should go to `python-list `_ or `tutor `_
52- or similar resources, such as StackOverflow _ or the ``#python `` IRC channel
57+ or similar resources, such as ` Stack Overflow `_ or the ``#python `` IRC channel
5358on Libera.Chat _.
5459
55- ` The core-workflow <https://github.com/python/core-workflow/issues >`_
60+ The ` core-workflow <https://github.com/python/core-workflow/issues >`__
5661issue tracker is the place to discuss and work on improvements to the CPython
5762core development workflow.
5863
@@ -62,28 +67,19 @@ https://mail.python.org/mailman3/ (newer lists, using Mailman3). Some lists may
6267be mirrored at `GMANE <https://gmane.io/ >`_ and can be read and posted to in various
6368ways, including via web browsers, NNTP newsreaders, and RSS feed readers.
6469
65- .. _issue tracker : https://github.com/python/cpython/issues
66- .. _python-committers : https://mail.python.org/mailman3/lists/python-committers.python.org/
67- .. _python-dev : https://mail.python.org/mailman3/lists/python-dev.python.org/
68- .. _python-help : https://mail.python.org/mailman/listinfo/python-help
69- .. _python-ideas : https://mail.python.org/mailman3/lists/python-ideas.python.org
7070.. _python-list : https://mail.python.org/mailman/listinfo/python-list
7171.. _tutor : https://mail.python.org/mailman/listinfo/tutor
72- .. _ StackOverflow : https://stackoverflow.com/
72+ .. _ Stack Overflow : https://stackoverflow.com/
7373.. _Libera.Chat : https://libera.chat/
74- .. _web gateway : https://mail.python.org/archives/
7574
7675
7776.. _communication-discourse :
7877
7978Discourse (discuss.python.org web forum)
8079========================================
8180
82- We have our own `Discourse `_ forum for both developers and users. This forum
83- complements the `python-dev `_, `python-ideas `_, `python-help `_, and
84- `python-list `_ mailing lists.
85-
86- This forum has different categories and most core development discussions
81+ We have our own `Discourse `_ forum for both developers and users.
82+ It has different categories and most core development discussions
8783take place in the open forum categories for `PEPs `_ and `Core Development `_
8884(these are the Discourse equivalents to the python-dev mailing list).
8985All categories are open for users to read and post with the exception of
0 commit comments