Open Source is really great and it has a lot of advantages but many people find it difficult to contribute to open source. I am writing this as a simple guide to make your first contribution on github.
First Contributions is a github repository that is focused helping beginners to make thier first open source contribution. I will guide you through the steps.
NB: You must have git installed on your computer.
Now lets start.
Navigate to the firstcontributions/first-contributions repository and fork it. Forking a repository is creating an exact copy of the repository in your github account up to the latest git commit message.
Click on the green code button and copy the clone link.
On your computer with git installed, navigate to the directory you want to save the files and open your terminal in the directory.
git clone <the_link_you_copied> # Example git clone https://github.com/dephraiim/first-contributions.git
To avoid any conflicts, create a branch to save all your changes then your branch will be merged.
First change into the directory with the command below
Then create a branch with the
git checkout -b <your_new_branch_name> # Example git checkout -b add-duncan
Open the directory in your code editor. I like vim. Then make changes to the
Add your name at the end of the file with your github profile link then save the changes.
<!-- Example --> - [Ephraim Atta-Duncan](https://github.com/dephraiim)
After you save the changes, head back to the terminal to commit your changes.
First, add the new changes to your branch with the
git add --all
Then commit the change with the
git commit -m "Add <your_name> to Contributors list" # Example git commit -m "Add Ephraim Atta-Duncan to Contributors list"
Push your changes to your remote repository using the
git push origin <your_branch_name> # Example git push origin add-duncan
git push has completed, head to your repository and you'll see this.
Now click on the Create Pull Request button to create a new Pull Request.
The repo has been linked to a bot so the pull request will be merged immediately
Congratulations 🎉, you just made your first contribution. The pull request will be merged very soon and you will get a notification email once the PR is merged.