Lets say there is a project called
python and you want to contribute. So you should fork
python project and ALWAYS create a separate branch for the patch/feature you are working on and NEVER commit on the master branch of forked repo.
Lets call your forked repo as
Once you fork a project, add a git remote called
upstream (or whatever name you feel like using), which points to original repo. This remote will help you keep your project updated and in sync with original repo (from where you forked).
$ cd python-forked $ git remote add upstream https://github.com/guido/python.git
Consider 3 scenarios.
The simple, fork and send PR
Create a new branch, name it on the patch/feature you are working on:
$ cd python-forked $ git checkout -b bugfix-unicode-strings
bugfix-unicode-strings and make all the changes you want. And then do a push to your github account, which is usually
$ git push origin bugfix-unicode-strings
And then send PR, to
master branch of
guido/python, with your branch
Now, tomorrow, guido may add new features and you might want to update your forked repo. It's simple, just pull from the
master branch of
$ cd python-forked $ git fetch upstream $ git checkout master $ git rebase upstream/master
Update and PR
You have forked the project and maintainer has later moved on and added new features which you need in the current patch you are working on
You need to fetch the new changes from
upstream and put those in your
patch branch. While doing this, usually I update my master branch also:
$ cd python-forked $ git fetch upstream $ git checkout master $ git rebase upstream/master $ git checkout existing-patch-I-am-working-on $ git rebase master
You could also do
$ git rebase upstream/master in last step to update the current patch branch.
Update, resolve conflicts and PR
You have forked the project and maintainer has made some changes to the file you are also working on
Fetch the changes and merge it with current patch branch you are working:
$ cd python-forked $ git fetch upstream $ git checkout master $ git rebase upstream/master $ git checkout existing-patch-I-am-working-on-which-has-a-file-edited-by-guido $ git rebase master
above rebase will fail(?) (or interrupted) and terminal will ask you to resolve the conflicts and then merge.
# solve the conflicts $ git rebase --continue