• Create a fork of the openboxes/openboxes repository
• Clone fork to your local machine

git clone [email protected]:<username>/openboxes.git

• Add openboxes repo as upstream (one-time only)

git remote add upstream git:https://github.com/openboxes/openboxes.git

• Fetch changes from upstream

git fetch upstream

• Sync master

git checkout master
git pull upstream master

• Sync develop

git checkout develop
git pull upstream develop

All bug fixes / improvements should be created as branches off the develop branch

• Checkout develop branch

git checkout -b feature/<ticket-number-and-description>

e.g. feature/1084-make-uploads-directory-configurable

• Do all development in branch

git add application.properties
git commit -m "Made a change to source file"

• Push all changes to branch in your forked repository

git push

• Create pull request (ticket name or commit message should be title of pull request)
• Check openboxes/openboxes to see if pull request shows up in list https://github.com/openboxes/openboxes/pulls