A Beginner's Guide to Contributing in an Open Source Project.
Learning to collaborate can be difficult for the first time contributors, and it may seem tedious to find open source projects to contribute to without adequate knowledge of programming. But fear not, this project is made especially to ease the process of contributing to an open source project for a newcomer.
Check out other awesome contributors of this project here.
Here are the steps to contribute to this project:
Type the following command on Git bash console:
git clone https://github.com/udit-001/Collaboration-For-Beginners.git
Replace the above git repo link with that of the fork you just created.
For that, first go to your terminal under the repo you just cloned, and type the following:
git checkout -b add-my-name
By running the above command, you just created a new branch called add-my-name
and checked it out, what this does is that it creates a new branch with the commit history of the master branch or the branch that you were on previously.
Contributors.md
and enter the details in the following format.#### Name: [YOUR NAME](GitHub Link)
- Place: City, Country
- Bio: Who are you?
- GitHub: [Your Name](GitHub Link)
terminal
:git add Contributors.md
git commit -m "Added myself to Contributors.md"
git push origin add-my-name
This will create a new commit with the changes you made in the Contributors.md
file. Then we pushed these updates on the add-my-name
branch of your fork.
"Added myself to Contributors.md"
After your pull request has been merged in the project, you can safely delete the branch called add-my-name
you created above.
You can do this by using the GitHub UI itself, just go the pull request you created and you will see something like this:
Just click on delete branch, and you're done.
Now if you were to contribute to a project only once, the above instructions would work just fine. But if you were to contribute to a project on a regular basis, you would run across a very common issue, that is how to update your fork with the changes made in the original project. So let's begin with the process:
git remote add upstream https://github.com/udit-001/Collaboration-For-Beginners.git
This just added a remote by the name upstream
to the original project.
git pull upstream master
That's it, now your repository is up to date with the changes in the original project.
git push origin master
And now, your fork is also up-to-date.
GitHub License Explained : https://choosealicense.com