Here we document Oppia's main communication channels and how to ask good questions.
If you need help, there are a few communication channels you can use. Developers usually respond within 24 hours so long as you use a channel they actually check.
We have several mailing lists in the form of Google Groups that you can join:
- oppia-announce is for announcements of new releases or blog posts. It's not for asking questions though.
- oppia-dev is the main mailing list for communication between developers and for technical questions. You can post to it even if you're not a member of the group. This is where you can ask questions, solicit feedback, or make developer-specific announcements (e.g. a temporary GitHub outage).
You can also email your mentor with any questions. If you don't have a mentor, complete the steps on the [[wiki page for contributing code to Oppia|Contributing-code-to-Oppia]] and you'll be assigned one.
If you have questions regarding Oppia you can create a discussion here where Oppia's Welfare team and other developers will assist you in resolving the issue. You can create a discussion in any of the following categories based on the question:
- Developer announcements: All announcements that affect developers for the Oppia repository will be announced here.
- Q&A (multiple categories): Any questions that developers have.
- General: General discussions that don't fit in any of the other categories.
You can refer to this guide on how to create a new discussion. You can also ping the welfare team by at-mentioning the welfare team: @oppia/web-welfare-team
Most Oppia developers and teams use Google Chat or Google Hangouts as their primary means of communication, and they usually respond quickly. However, invites often get lost in spam folders, and some developers use a non-public email address for Google Chat. You can ask your mentor to put you in touch with a developer if you don't know their address or if they haven't acted on your invite.
If you have a question about a pull request or issue, you can also reach out to developers by at-mentioning them (e.g. @developer-username) in a comment and assigning them to the issue. Be sure you both at-mention and assign them! Some developers only look at their GitHub notifications (which at-mentions trigger), while others only look at what they're assigned to.
You can even mention whole teams of people! For example, if you find an issue that is destabilizing the project, you could notify all the core maintainers by including @oppia/core-maintainers in your issue. The teams are all listed here.
At Oppia we don’t care how silly your question is! Just ensure your question is clear, and provide us with enough information to help us resolve it faster. We've divided the questions into 2 categories - Setup-related and General questions. You can start following the sections below to understand how you can ask each of them.
-
You can setup/install Oppia by visiting [[this page|Installing-Oppia]]. Make sure you follow all the mentioned instructions from the beginning in a step-by-step manner.
-
Make sure each step succeeds (verify it with the expected behavior if mentioned in the wiki).
-
In case of any unexpected behavior/errors at any step, make sure you check out our wiki on how to troubleshoot when you are facing installation errors.
If you are still not able to fix your error, start following the section below to raise your question on GitHub Discussions.
Note If you are stuck at Step X, we will assume all previous steps through X-1 were successful for you. In case there were any previously failed steps, kindly mention those too with their error logs.
Please follow the template given below (mark x inside checkboxes to tick them) for creating a GitHub Discussions.
**Checklist**
- [ ] I have followed the [Before you ask a setup question](https://github.com/oppia/oppia/wiki/Get-help#before-you-ask-a-setup-question) section of the wiki.
**System Information**
- OS: (Be specific Ex: Ubuntu 20.04 or Ubuntu 20.04 VM on MacOS 11.2.1)
**Steps followed**
// If you encountered this error while following a wiki page, provide a link to the page and specify which step failed. Otherwise, list what steps caused the error. These should be detailed enough for someone else to follow them.
**Error log**
//paste error log here
or
paste a screenshot
**Approaches already used to resolve the issue**
(eg: Link to a Stack Overflow answer or any solution that you have tried)
- enter any additional description- We expect that you have already set up Oppia on your machine, and it is successfully running. (If not, kindly do that first!)
- Prepare a debugging doc following [[the guidelines provided on the wiki page|Debugging-Docs]].
- If there are failing e2e tests on your PR, and you haven’t done any changes in that direction, kindly understand that sometimes they just fail due to flakiness. You should request for a re-run of those only when it’s preventing your PR from getting merged.
Follow the template below for asking questions (fill in the values inside {{}} brackets and mark x inside checkboxes to tick them) to leave a comment on a pull request. Adapt the template as needed if you are using another channel.
@{{PR reviewer or Mentor username}} PTAL!
**Checklist**
- [ ] I have filled the [CLA](https://goo.gl/forms/AttNH80OV0) and the [Oppia Contributor Survey](https://goo.gl/forms/otv30JV3Ihv0dT3C3)
- [ ] I have setup Oppia locally (verified by running `python -m scripts.start`)
- [ ] I have worked through the [Before you ask a setup question](https://github.com/oppia/oppia/wiki/Get-help#before-you-ask-a-setup-question) section of the wiki.
**System Information**
- OS: (Be specific Ex: Ubuntu 20.04)
- [ ] Virtual machine
**About the issue**
- {{Describe the problem}} (eg. Failing e2e tests: "The test has been
failing repeatedly since {{x}} previous runs, and I haven’t done any
changes related to it. Requesting a re-run.")
**Approaches already used to resolve the issue**
(eg: Link to a Stack Overflow answer or any solution that you have tried)
- #{{Link to the debugging doc}}
- enter any additional description-
If you are unable to push changes due to some reason, you can create a patch file and share it with the person you're asking for help.
-
If you are facing issues in completing the assigned task, you can create a PR on your fork of the Oppia repository, troubleshoot your problem on that pull request with help from your mentor, and then create a new PR on the original Oppia repository.
-
If you have not made a PR yet, because you are not sure:
- what the issue is about, or
- which files have to be modified, or
- if your approach towards the solution is correct
Then ask for help by commenting with your doubt/suggested approach on the issue page itself. If you don’t get any response within 24 hours, you can drop a message on GitHub Discussions too.
-
If you want to have a discussion on your approach, but aren’t ready to make a PR yet, you can create a public gist and include the link to it in your question. It’s always better to see the code you are talking about!
-
Avoid asking for help from people via emails or direct messaging. We encourage everyone to ask for help on a common channel so that whoever sees your query first can help you or guide you how to take your query forward.
-
Comment on the issue page or the PR if your question is very specific.
-
Use GitHub Discussions if your question is not issue-specific.
-