Making your first Open Source Pull Request | Github

Open Source softwares are softwares for which the original source code is made freely available and may be redistributed and modified. As a Programmer, we are more interested in how to contribute to their codebase. A lot of newcomers find Open Source to be dreadful and daunting. But worry not, every great Open Source contributor had once been in a place that you are in right now. The following article may be helpful for those who wanna step into the amazing world of Open Source. Before we begin Following are the prerequisites required before diving into Open Source:

• Good understanding of at-least one programming language of your choice
• Version Control: Git/SVN and Github/Bitbucket/Gitlab
• Learn to read large source code so that it doesn't appear gibberish. This article might help.
• Learn how to use Bug/Issue Trackers

Where to start? Following are a few resources found to be useful for newcomers:

• Up-for-grads
• Open Hatch
• Github: Great for new contributors
• Firsttimersonly

The given resources consists of a list of projects by different organisations which can be filtered on the basis of programming languages used, category of project(Eg. Web, Databases, etc) and difficulty. Steps to make a Pull Request: Once you decide the repository you want to contribute to or the issue you want to work on, follow the steps in order to make your first pull request:

1. Read the CONTRIBUTING.md guide(If present)

2. Discuss with the maintainers about the issue, ask questions(if any) and clear doubts. They are lovely people and are always ready to help. You might also ping them over their IRC or Mailing lists.
3. Go ahead and Fork the repository

4. Clone the repo: git clone https://github.com/YOUR_USERNAME/PROJECT.git

5. Add Upstream: git remote add upstream https://github.com/PROJECT_USERNAME/PROJECT.git
6. Create new branch: git checkout -b BRANCH_NAME

7. Code Code Code: Make required changes
8. Push changes: git push origin BRANCH_NAME
9. Create pull request through Github

Some other useful commands:

• To check remote links: git remote -v
• To check Branches: git branch
• To delete branch: git branch -D BRANCH_NAME
• To delete branch on Github: git push origin --delete BRANCH_NAME

Now all you have to do is wait for your changes to be reviewed by the maintainers and merged(or discarded). It feels good when you find that a piece of your written code is being used by people all around the world on a daily basis. On a side note, you might wanna check out GSOC. If this doesn't motivate you begin with Open Source, then nothing else might. See Also - How to get started with Open Source.