From 2bbd06dacff52977a6520827f80d554e292ad701 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?R=C3=A9gis=20Behmo?= Date: Tue, 19 Nov 2019 13:47:54 +0100 Subject: [PATCH 1/2] Point to the discussion forum as the main community entry point Slack should no longer be used for asking for help. Instead, people should head to the discussion forums at https://discuss.openedx.com. --- CONTRIBUTING.rst | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index d778623ac8..dc1b3b1a45 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -41,6 +41,24 @@ pull request. .. _start a discussion on JIRA: https://openedx.atlassian.net/secure/Dashboard.jspa .. _create a free JIRA account: https://openedx.atlassian.net/admin/users/sign-up +.. _forum: + +Discussion forum +---------------- + +To ask technical questions and chat with the community, do not hesitate to join the +`Open edX discussion forum `__. There are different +categories for different topics: + +- `Devops `__ for installation help +- `Development `__, where Open edX developers + unite +- `Community `__ to discuss organizational + matters in the open source community +- `Announcements `__ where official Open edX + announcement are made +- `Educators `__, to discuss online learning in general + Slack ----- @@ -51,12 +69,14 @@ between 13:00 and 21:00 UTC (9am to 5pm US Eastern time), but interesting conversations can happen at any time. There are many different channels available for different topics, including: -* ``#ops`` for installation help * ``#events`` for upcoming events related to Open edX * ``#content`` for discussions about course content and creating the best courses And lots more! You can also make your own channels to discuss new topics. +Note that Slack is no longer the recommended communication channel to ask about +technical issues. To do so, you should instead join the `official forum <#forum>`__. + .. _Slack: https://slack.com/ .. _Sign up for a free account: https://openedx-slack-invite.herokuapp.com/ From 0717e28e21cf8271193ff80acb48cdcd314a293f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?R=C3=A9gis=20Behmo?= Date: Tue, 19 Nov 2019 13:54:39 +0100 Subject: [PATCH 2/2] Deprecate mailing lists as a community discussion channel --- CONTRIBUTING.rst | 35 +++++++---------------------------- 1 file changed, 7 insertions(+), 28 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index dc1b3b1a45..ae08aba526 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -22,10 +22,9 @@ JIRA ---- If you've got an idea for a new feature or new functionality for an existing feature, -please start a discussion on the `edx-code`_ mailing list to get feedback from -the community about the idea and your implementation choices. - -.. _edx-code: https://groups.google.com/forum/#!forum/edx-code +please start a discussion in the `development `__ +category of the discussion forum list to get feedback from the community about the idea +and your implementation choices. If you then plan to contribute your code upstream, please `start a discussion on JIRA`_ (you may first need to `create a free JIRA account`_). @@ -33,10 +32,9 @@ Start a discussion by visiting the JIRA website and clicking the "Create" button top of the page. Choose the project "Open Source Pull Requests" and the issue type "Feature Proposal". In the description give us as much detail as you can for the feature or functionality you are thinking about implementing. Include a link to any relevant -edx-code mailing list discussions about your idea. We encourage you to do this before -you begin implementing your feature, in order to get valuable feedback from the edX -product team early on in your journey and increase the likelihood of a successful -pull request. +forum discussions about your idea. We encourage you to do this before you begin +implementing your feature, in order to get valuable feedback from the edX product team +early on in your journey and increase the likelihood of a successful pull request. .. _start a discussion on JIRA: https://openedx.atlassian.net/secure/Dashboard.jspa .. _create a free JIRA account: https://openedx.atlassian.net/admin/users/sign-up @@ -80,25 +78,6 @@ technical issues. To do so, you should instead join the `official forum <#forum> .. _Slack: https://slack.com/ .. _Sign up for a free account: https://openedx-slack-invite.herokuapp.com/ -Mailing Lists -------------- - -For asynchronous conversation, we have several mailing lists on Google Groups: - -* `openedx-ops`_: everything related to *running* Open edX. This includes - installation issues, server management, cost analysis, and so on. -* `openedx-translation`_: everything related to *translating* Open edX into - other languages. This includes volunteer translators, our internationalization - infrastructure, issues related to Transifex, and so on. -* `openedx-analytics`_: everything related to *analytics* in Open edX. -* `edx-code`_: everything related to the *code* in Open edX. This includes - feature requests, idea proposals, refactorings, and so on. - -.. _openedx-ops: https://groups.google.com/forum/#!forum/openedx-ops -.. _openedx-translation: https://groups.google.com/forum/#!forum/openedx-translation -.. _openedx-analytics: https://groups.google.com/forum/#!forum/openedx-analytics -.. _edx-code: https://groups.google.com/forum/#!forum/edx-code - Byte-sized Tasks & Bugs ----------------------- @@ -215,7 +194,7 @@ By opening up a pull request, we expect the following things: unable to participate in the review process. 3. If you have questions, you will ask them by either commenting on the pull - request or asking us in Slack or on the mailing list. + request or asking us in the discussion forum or on Slack. 4. If you do not respond to comments on your pull request within 7 days, we will close it. You are welcome to re-open it when you are ready to engage.