Setting up

To contribute a change to the IGB code base, create your own fork of the IGB repository.

To create your own fork:

Next, you'll see a form that let's you give your fork a name and description. Here's an example:

Fill in the fields and click Fork repository.

After a moment, the Overview page for your forked repository will appear. Click Settings and change the main branch to the IGB development branch.

See Atlassian documentation Forking a Repository

Clone your fork

Clone a copy of your forked IGB repository onto your local computer. You will make changes to your local clone, commit them to your local repository, and then ultimately push your changes upstream to your fork.

To clone your fork, use git clone with the address of your fork. (Copy the address from the Overview page.)

Make a branch

However, before you get started, you should first create a new branch for the changes you intend to make. This will allow you to issue focused, low risk pull requests that can be easily merged with other branches of development.

To make a branch:

git checkout igb_8_3
git branch <BRANCH> 

where BRANCH is the name of the branch, e.g., IGBF-203, the name of a story in the IGB JIRA issue-tracking system.

Now, all commits will be associated with the branch you've just created. Commit your changes and then push them to your fork hosted on bitbucket.

Issue pull request

To request that your edits be incorporated into the main line of development:

A Pull request form will appear. Fill in the fields: