In this article, we will discuss GitHub Workflow and how to contribute to open-source projects on GitHub.
Table Of Contents
- Fork A Repository
- Clone Forked
- Create A New Branch
- Add Commits
- Push To Forked Repository
- Create A Pull Request
- Code Review
- PR Merged
Fork A Repository
First of all, we need to fork a repository. A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
Suppose if you want to contribute in freeocdecamp then you need to fork freecodecamp repository to contribute.
You can see a fork button on the top right corner.
Clone Forked
Now clone the forked repository by clicking clone or download button and open it in your favorite IDE to make changes.
Create A New Branch
Now our forked repository is cloned and we have opened it in our favorite IDE now we need to create a local branch with this command.
git checkout -b branch_name //This will create a new branch locally
Add Commits
Now we need to make changes and add commits locally.
The command is given below.
git add . //This will add local changes
git commit -m "commit_name" //This will add local changes and add the commit
This command will add local commits.
Push To Forked Repository
Now we need to push our local branch and commit to the remote (forked) repository.
The command is given below.
git push //This will push changes to remote branch
Create A Pull Request
Now we have pushed local changes to the remote forked repository. Now we need to create a pull request which will be sent to the remote original repository.
After pushing the code we need create a new pull request by click on create pull request button and create a PR and select your branch to which you have made changes.
Code Review
Our PR is created successfully now we need to wait for our code to be review by the repository contributor/owner.
PR Merged
Our code is reviewed successfully by contributor/owner and now your PR is in a ready state to merge with the original repository.
The original repository owner will merge your PR. Hurray!
Congratulations you have successfully contributed to open source.
Top comments (0)