Outdated CONTRIBUTING File
See original GitHub issueFirst Timers Only
This issue is reserved for people who haven’t contributed to our codebase before, or never contributed to Open Source. About First Timers Only.
We know that the process of creating a pull request is the biggest barrier for new contributors. This issue is for you 💝
If you have contributed before, consider leaving this one for someone new and looking through our general help wanted issues. Thanks!
🤔 What you will need to know.
Nothing. This issue is meant to welcome you to Open Source 😃 We are happy to walk you through the process.
What is to be done?
The CONTRIBUTING.md file, that has instructions/guidelines for new contributors, was written a long time ago and some sections are a little outdated.
For example, the file refers to src/
directory which no longer exists.
You’ll have to:
- Check for broken links and old references.
- Wrong instructions.
- Fix em!
🔎 Files To Look Into:
📋 Step by Step
- 📜 Read The CONTRIBUTING File: We welcome contributions from everyone, the CONTRIBUTING will help you get started.
NOTE: Useful links:
-
Fork This Repository: A fork is a copy of this repository that is stored under your github account. A fork can be used to test out changes separately and then request to add those to the main repository as well!
-
🙋 Claim this issue: Comment below. If someone else has claimed it, ask if they’ve opened a pull request already and if they’re stuck – maybe you can help them solve a problem or move it along!
-
Create A New Branch: A branch is used to test new changes before they are merged with the stable
master
branch. You can create a new branch in the terminal. Make sure to name it descriptively! -
📝 Make The Requested Changes
-
✅ Commit Your Changes: A Git commit is a change that is finalized and recorded in the branch.
-
🔀 Start a Pull Request(PR). There are two ways how you can start a pull request:
-
If you are familiar with the terminal or would like to learn it, here is a great tutorial on how to send a pull request using the terminal.
-
You can also open a PR from the browser.
- 🏁 Done Ask in comments for a review 😃
Please keep us updated
💬 🔔 - We encourage contributors to be respectful to the community and provide an update within a week of claiming a first-timers-only issue. We’re happy to keep it assigned to you as long as you need it if you update us with a request for more time or help, but if we don’t see any activity a week after you claim it we may reassign it to give someone else a chance. Thank you in advance!
If this happens to you, don’t sweat it! Grab another open issue.
Is someone else already working on this?
🔗- We encourage contributors to link to the original issue in their pull request so all users can easily see if someone’s already started on it.
👥- If someone seems stuck, offer them some help! Otherwise, take a look at some other issues you can help with. Thanks!
🤔❓ Questions?
Leave a comment below!
Issue Analytics
- State:
- Created 3 years ago
- Comments:6 (6 by maintainers)
Top GitHub Comments
Your PR will be merged by a maintainer after reviewing.
On Mon, 11 May, 2020, 4:26 PM Manish Kumar Barnwal, < notifications@github.com> wrote:
Fixed via #4171