GIT-ting Started
This page only applies to SU2 version 6.2.0 and lower.The new documentation section can be found here.
As you now know, GitHub is the center of all development efforts in SU2. The su2code organization contains the main code repository as well as supporting materials. You can check out all of the development activity, and new developers are encouraged to log feature requests, questions, and bug reports through the GitHub issue tracker. Developers can have their code contributions integrated through GitHub as well. For more information, keep reading!
Branching Model
We follow a popular git branching strategy in order to leverage decentralized development. This list describes the types of branches on the SU2 repository. You’ll want to pick the right one to work with, in order keep the merging process simple.
- master – stable, latest release and fixes
- develop – current development, generally the branch for you to fork or start a new branch from
- feature_* – feature specific branches
- fix_* – branches that fix a particular bug or capability (not new features)
Contributing Code
SU2 merges new code contributions through pull requests. As a new developer, you’ll want to fork SU2 to your personal account. This creates a clone of the whole SU2 repository, branches and all, inside your github account. Generally you’ll want to start from the develop branch, but you can check with the developers if you think it would be more appropriate to work on a feature branch.
You can push all of your working changes to your forked repository. Once you’re happy with these, and want to push them to the origin repository, submit a pull request to the ‘develop’ branch under the SU2 repo. Make sure to pull any new changes from the origin repository before submitting the pull request, so that the changes can be merged more simply. The SU2 developers will review the changes, make comments, ask for some edits. Then when everything looks good, your changes will merge into the main development branch!