Skip to content

help: Add link to Discourse instance #596

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.

Sign up for GitHub

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

Merged
willingc merged 2 commits into from
Oct 19, 2020
Merged

help: Add link to Discourse instance #596

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3b35aea
help: Add link to Discourse instance
EricCousineau-TRI Jul 10, 2020
038e40c
Address Mariatta's comments
EricCousineau-TRI Jul 10, 2020
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
Prev Previous commit
Address Mariatta's comments
  • Loading branch information
@EricCousineau-TRI
EricCousineau-TRI authored Jul 10, 2020
commit 038e40cc6a11f5d15ddcada36c291953efc6f157
58 changes: 31 additions & 27 deletions help.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,40 @@ 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 <https://discuss.python.org/c/core-dev/23>`_ and
`Core Workflow <https://discuss.python.org/c/core-workflow/8>`_.

.. _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
---------------

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::

Expand All @@ -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
Expand Down Expand Up @@ -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
----------

Expand Down