Getting started with Open Source Software

Being up-to-date and avoiding conflicts

 Found a typo? Edit me

Have you ever wondered how you could collaborate with open-source projects, but you didn't know how to start? It couldn't be easier. Take a look:

git clone

(master)$ git remote add upstream
# If you run `git remote -v` you should see:
origin (fetch)
origin (push)
upstream (fetch)
upstream (push)

Get the last changes in your project (not necessary if you just forked the project).

(master)$ git fetch upstream master
(master)$ git merge upstream/master
(master)$ git checkout -b new-branch

Once you're done, let’s create a PR!

(new-branch)$ git add . # Add to git your changes
(new-branch)$ git commit -m ‘Type the commit message’
(new-branch)$ git push origin new-branch # Push in forked & origin
(master)$ git remote set-url origin

That's all!

If your changes (or someone else’s) have been merged in the origin, you need to run fetch upstream master and git merge upstream/master in master to be up-to-date!


To sum up

# Synchronize your local repository to the original one
# Need to run only once the first time
git remote add upstream
# Get all changes from sync project into upstream branch
git fetch upstream master
# Merge upstream branch into your current branch
git merge upstream/master