# Gitflow
Gitflow, the Git workflow first published and made popular by Vincent Driessen at nvie (opens new window), is now considered best practice for continuous software development and DevOps practices. It defines a strict branch model designed for project release, which is suitable for projects with a scheduled release cycle and continuous delivery.
An example of standard Gitflow is as follows:
The overall flow of Gitflow is as follows:
- A develop branch is created from master.
- A release branch is created from develop.
- Feature branches are created from develop.
- When a feature is complete it is merged into the develop branch.
- When the release branch is done it is merged into develop and master.
- If an issue in master is detected a hotfix branch is created from master.
- Once the hotfix is complete it is merged to both develop and master.
# Develop/Master Branch
Gitflow uses two branches to record the history of the project. The master branch stores the official release history, and the develop branch serves as an integration branch for features. The develop branch interacts with each feature branch as the completed feature is integrated into develop, and new branch is branched off of develop for new features.
It's also convenient to tag commits in the master branch with a version number and then release to the production environment.
# Feature Branch
Each new feature should reside in its own branch.
Feature branches are generally created off to the latest develop branch. When a feature is complete, it gets merged back into develop. Features should never interact directly with master.
# Release Branch
Once develop has acquired enough features (or a predetermined release date is approaching), it is time for a release. Fork a release branch off of develop, which indicates the end of this release cycle and starts the next release cycle. Then no new features can be added after this point.
Only bug fixes, documentation generation, and other release-oriented tasks should go in this branch.
For bugfix on the release branch, a new branch should be branched off and get merged into release and develop after the bug is fixed and verified.
Once it's ready to ship, the release branch gets merged into master and tagged with a version number.
# Hotfix Branch
Hotfix branches are used to quickly patch production releases. When a bug occurs, a hotfix branch is forked off of main. As soon as the fix is complete, it should be merged into both master and develop, and master should be tagged with an updated version number.