Branch Based Workflow for QGis

This workflow might be useful for you if:

• you work on multiple features/bugs at a time
• you do not have write permission at the qgis repository(you can only issue pull requests).

This workflow is strictly branch based. That is, you are never going to do any real work in master.

1. Login to GitHub
2. Fork the project at https://github.com/qgis/qgis by clicking “Fork”. This may take a while
3. Create a local folder and switch to it

mkdir qgisdev
cd qgisdevgit

4. Create a working copy of the latest qgis source in this local folder

git clone git@github.com:YOURNAME/Quantum-GIS.git

5. Now we tell git that this local repository belongs to the real qgis repository. We do this by specifying upstream.

git remote add upstream https://github.com/qgis/Quantum-GIS.git

6. Bring your master branch up to date with the latest changes in Qgis Repository.

   git checkout master
   git fetch upstream
   git rebase upstream/master
   

7. Now Create a branch from master branch.

git checkout -b myBranch

8. Do you work modifying source code and commit often as you like.

git commit -m "work started"

9. Make more changes and follow-up with more git commits.
10. A few days might have gone by since your creation of this branch. Now you want to make this branch up to date with the latest in server.

git checkout master
git fetch upstream
git rebase upstream/master

11. come back to your branch and update all changes from master to this branch

git checkout myBranch
git rebase master

12. more commits(git commit -m “etc..”)

now you see that you are ready to issue a pull request..
update master again as we did previously and follow it by a rebase -i to format your commit comments.

git rebase master -i
git push origin myBranch

now you can issue a pull request from github website.

13. Some experienced devs would review your pull request and might ask you to change something. You just make the changes again
    in your branch followed by commits. Again update master and rebase with master.
    Update your pull request by pushing to your branch:

    git push origin myBranch
    

    Now the changes would be visible in your current pull request.