From 043e238b91cde31650929a2972d831139873d9c9 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Sat, 16 Dec 2023 21:03:53 +0530 Subject: [PATCH 1/3] docs: Update mailing list information in devguide Signed-off-by: Abhishek Kumar --- .github/CONTRIBUTING.md | 6 ++++-- developer-workflow/communication-channels.rst | 6 +++--- getting-started/getting-help.rst | 4 ++-- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index c54abaedce..668b59dbdf 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -33,8 +33,10 @@ 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). + +Please note that the traditional `python-dev` mailing list has been retired. ## Code of Conduct diff --git a/developer-workflow/communication-channels.rst b/developer-workflow/communication-channels.rst index 12e14889e9..944e4a6a2f 100644 --- a/developer-workflow/communication-channels.rst +++ b/developer-workflow/communication-channels.rst @@ -45,7 +45,7 @@ Mailing lists should go to the python-list_ or python-help_ mailing lists, or the `Python Help`_ category on Discourse. -Existing threads on the python-dev_, python-committers_, and python-ideas_ mailing lists +Existing threads on the python-core-dev_, python-committers_, and python-ideas_ mailing lists can be accessed through the `online archive `__. General Python questions should go to `python-list`_ or `tutor`_ @@ -64,7 +64,7 @@ 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-core-dev: https://discuss.python.org/c/core-dev/23 .. _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 @@ -80,7 +80,7 @@ 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 +complements the `python-core-dev`_, `python-ideas`_, `python-help`_, and `python-list`_ mailing lists. This forum has different categories and most core development discussions diff --git a/getting-started/getting-help.rst b/getting-started/getting-help.rst index 4e5a02c39b..07ebb988ef 100644 --- a/getting-started/getting-help.rst +++ b/getting-started/getting-help.rst @@ -43,7 +43,7 @@ Mailing lists ------------- Further options for seeking assistance include the -`python-ideas`_ and `python-dev`_ mailing lists, +`python-ideas`_ and `python-dev`_ communication channels, which correspond to the `Ideas`_ and `Core Development`_ :ref:`help-discourse` categories, respectively. The Discourse categories are generally more active @@ -53,7 +53,7 @@ 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/ +.. _python-dev: https://discuss.python.org/c/core-dev/23/ Ask #python-dev From 58fcc5bf3c91bf1ced71888f0ba3d207f4136202 Mon Sep 17 00:00:00 2001 From: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Date: Mon, 3 Feb 2025 18:06:25 +0000 Subject: [PATCH 2/3] Update .github/CONTRIBUTING.md --- .github/CONTRIBUTING.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 668b59dbdf..0029b4208e 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -36,8 +36,6 @@ If no core developer has done a review or responded to changes made because of a "changes requested" review, please consider seeking assistance through the [Core Development Discourse category](https://discuss.python.org/c/core-dev/23). -Please note that the traditional `python-dev` mailing list has been retired. - ## Code of Conduct From 4ad329459e1f1ea37c72bb6e5bd96d8dad1e77b8 Mon Sep 17 00:00:00 2001 From: Adam Turner <9087854+aa-turner@users.noreply.github.com> Date: Mon, 3 Feb 2025 18:18:00 +0000 Subject: [PATCH 3/3] Adam's review points --- developer-workflow/communication-channels.rst | 38 +++++++++---------- getting-started/getting-help.rst | 19 ---------- 2 files changed, 17 insertions(+), 40 deletions(-) diff --git a/developer-workflow/communication-channels.rst b/developer-workflow/communication-channels.rst index 944e4a6a2f..38785d1904 100644 --- a/developer-workflow/communication-channels.rst +++ b/developer-workflow/communication-channels.rst @@ -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. @@ -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-core-dev_, python-committers_, and python-ideas_ mailing lists -can be accessed through the `online archive `__. + Previous threads on the python-dev_, python-committers_, and python-ideas_ + mailing lists can be accessed through the `online archive + `__. + + .. _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 `_ +The `core-workflow `__ issue tracker is the place to discuss and work on improvements to the CPython core development workflow. @@ -62,16 +67,10 @@ https://mail.python.org/mailman3/ (newer lists, using Mailman3). Some lists may be mirrored at `GMANE `_ 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-core-dev: https://discuss.python.org/c/core-dev/23 -.. _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: @@ -79,11 +78,8 @@ ways, including via web browsers, NNTP newsreaders, and RSS feed readers. Discourse (discuss.python.org web forum) ======================================== -We have our own `Discourse`_ forum for both developers and users. This forum -complements the `python-core-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 diff --git a/getting-started/getting-help.rst b/getting-started/getting-help.rst index 07ebb988ef..e7883e7183 100644 --- a/getting-started/getting-help.rst +++ b/getting-started/getting-help.rst @@ -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`_ communication channels, -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://discuss.python.org/c/core-dev/23/ - - Ask #python-dev ---------------