From 3b35aeaa2addc6e30ec4203ff6fa8ad1d771c099 Mon Sep 17 00:00:00 2001 From: Eric Cousineau Date: Fri, 10 Jul 2020 14:19:08 -0400 Subject: [PATCH 1/2] help: Add link to Discourse instance Add note that IRC channel may not have history, and thus may not be easily searchable for newcomers. (I could not easily find a discussion archive) --- help.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/help.rst b/help.rst index 2df8022dc9..51a5db2ebc 100644 --- a/help.rst +++ b/help.rst @@ -23,8 +23,12 @@ questions about developing for Python. Just remember that ``#python-dev`` is for questions involving the development *of* Python whereas ``#python`` is for questions concerning development *with* Python. -.. _freenode: https://freenode.net/ +.. note:: + + You may not be able to access the history of this channel, so it cannot + be used as a "knowledge base" of sorts. +.. _freenode: https://freenode.net/ Zulip ----- @@ -36,6 +40,14 @@ an office hour, before posting to python-dev mailing list or filing bugs. .. _Zulip: https://python.zulipchat.com +Discourse +--------- + +Python has a hosted `Discourse`_ instance. Be sure to visit the related Core +categories, such as Core Development and Core Workflow. + +.. _Discourse: https://discuss.python.org/ + Core Mentorship --------------- From 038e40cc6a11f5d15ddcada36c291953efc6f157 Mon Sep 17 00:00:00 2001 From: Eric Cousineau Date: Fri, 10 Jul 2020 17:45:11 -0400 Subject: [PATCH 2/2] Address Mariatta's comments --- help.rst | 58 ++++++++++++++++++++++++++++++-------------------------- 1 file changed, 31 insertions(+), 27 deletions(-) diff --git a/help.rst b/help.rst index 51a5db2ebc..50e3b982a1 100644 --- a/help.rst +++ b/help.rst @@ -12,6 +12,30 @@ Should you require help, there are a :ref:`variety of options available usage then please check the rest of this guide first as it should answer your question. +Discourse +--------- + +Python has a hosted `Discourse`_ instance. Be sure to visit the related Core +categories, such as +`Core Development `_ and +`Core Workflow `_. + +.. _Discourse: https://discuss.python.org/ + +Mailing Lists +------------- + +Further options for seeking assistance include the `python-ideas`_ and +`python-dev`_ mailing lists. Python-ideas contains discussion of speculative +Python language ideas for possible inclusion into the language. If an idea +gains traction it can then be discussed and honed to the point of becoming a +solid proposal and presented on python-dev. Python-dev contains discussion +of current Python design issues, release mechanics, and maintenance of +existing releases. These mailing lists are for questions involving the +development *of* Python, **not** for development *with* Python. + +.. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas +.. _python-dev: https://mail.python.org/mailman/listinfo/python-dev Ask #python-dev --------------- @@ -19,9 +43,9 @@ Ask #python-dev If you are comfortable with IRC you can try asking on ``#python-dev`` (on the `freenode`_ network). Typically there are a number of experienced developers, ranging from triagers to core developers, who can answer -questions about developing for Python. Just remember that ``#python-dev`` -is for questions involving the development *of* Python whereas ``#python`` -is for questions concerning development *with* Python. +questions about developing for Python. As with the mailing lists, +``#python-dev`` is for questions involving the development *of* Python +whereas ``#python`` is for questions concerning development *with* Python. .. note:: @@ -38,15 +62,12 @@ for asking help with core development, as well as core developers' office hour stream. It is preferred that you ask questions here first or schedule an office hour, before posting to python-dev mailing list or filing bugs. -.. _Zulip: https://python.zulipchat.com - -Discourse ---------- +.. warning:: -Python has a hosted `Discourse`_ instance. Be sure to visit the related Core -categories, such as Core Development and Core Workflow. + This is no longer actively monitored by core devs. Consider asking your questions + on Discourse or on the `python-dev`_ mailing list. -.. _Discourse: https://discuss.python.org/ +.. _Zulip: https://python.zulipchat.com Core Mentorship @@ -90,23 +111,6 @@ during office hours. .. _Mariatta's twitter: https://twitter.com/mariatta -Mailing Lists -------------- - -Further options for seeking assistance include the `python-ideas`_ and -`python-dev`_ mailing lists. Python-ideas contains discussion of speculative -Python language ideas for possible inclusion into the language. If an idea -gains traction it can then be discussed and honed to the point of becoming a -solid proposal and presented on python-dev. Python-dev contains discussion -of current Python design issues, release mechanics, and maintenance of -existing releases. As with ``#python-dev``, these mailing lists are for -questions involving the development *of* Python, **not** for development -*with* Python. - -.. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas -.. _python-dev: https://mail.python.org/mailman/listinfo/python-dev - - File a Bug ----------