Article Image

Git(Hub) Flow, Trunk Based Development, and Code reviews

17th June 2021 ・ By Adriano Martins

The right branching model will improve any team's collaboration skills, quality, and speed. The wrong model will do exactly the opposite. These are the 3 most used.

Name a company that develops software. There's a very high chance they are are using Git to source control their codebase. Actually, there's a 77% chance, according to Smartbear's State of Code Review 2020 Report.

There's also a very high chance any given company has a code review process in place. An 84% chance according to Codegrip's Code Review Trends in 2020 report.

However, there isn't a single standardized methodology to develop software using Git and Code Reviews. This is because whatever strategy is best is highly dependent on the team and the project's characteristics. It's entirely up to the team to choose which methodology better suits their software development needs and goals.

Let's take a look at the 3 main methodologies (also called branching models or branching strategies):

  • Git Flow
  • GitHub Flow
  • Trunk Based Development

The original: Git Flow

Rarely does a blog post impact the industry as the one Vincent Driessen published on January 05, 2010, named A successful Git branching model.

In his post, Driessen laid out Git Flow, a robust and strict branching model that became the industry standard for software development for years.

It brought parallel development to the masses, created the perfect conditions for collaborative programming, and it scaled easily.

With it, many companies managed to grow large and efficient teams and to deploy very complex software.

With Git Flow, the repository is centered on the main and develop branches, and it is supported by feature-n, release, and hotfix branches, as described in this diagram:

Git Flow

Code Reviews play an essential part in ensuring the code is up to standard and bug-free when merging feature branches to the develop branch.

Git Flow allows for a very methodic and orchestrated software development but comes at a very high cost:

  • the sheer volume of branches and their overhead are a nightmare to maintain
  • teams have to be extremely disciplined, otherwise they will end up with long-lived branches which become impossible to merge

The successor: GitHub Flow

With the advent of web apps and continuous delivery, a lighter and faster branching model gained traction: GitHub Flow. As you might've guessed, it was created and popularized by the GitHub themselves.

It's centered on the main and feature branches. Main is always releasable. Developers create a new feature branch to make changes. After reviewing these changes for bugs and code quality they will be deployed to production. If they cause problems, a rollback from main will take place. Otherwise, the feature branch will be merged to the main branch.

GitHub Flow

Compared to Git Flow, GitHub Flow is much lighter. Maintenance is very low because the only long-lived branch is Main.

However, GitHub Flow inherits other drawbacks from Git Flow. Undisciplined teams that keep feature branches open for weeks risk serious problems when trying to merge. Ultimately, a failed merge can leave main undeployable, and that's a big red flag for continuous delivery.

The shift: Trunk-Based Development

Also going by TBD, Trunk-Based Development is somewhat famously documented at In this branching model, developers make changes directly in a single branch called trunk.

Trunk is deployable at all times. Changes should be summited daily. Unfinished features should be unexposed with the help of feature flags.

Trunk-Based Development for Small Teams

Yes, you read it right. It sounds like Yolo Software Development. There is no code review in TBD, either.

The catch is that this method can only work with/for small teams, with seasoned developers. Pair-programming is highly recommended. The pace is very fast because there is very little, if any, overhead. The team must be very skilled and cautious because everything goes directly to the trunk.

This TBD model is actually officially called Trunk-Based Development For Smaller Teams. Despite its shortcomings, TBD for Smaller Teams is highly regarded by the software development community for its extremely lightweight workflow.

The seasoned: Scaled Trunk-Based Development

Luckily, TBD has another trick up its sleeve: Scaled Trunk-Based Development. In order to operate at scale, this branching model uses short-lived feature branches with a life span of a few days (maximum) before merging to the trunk, which is deployable at all times.

Work in progress should be kept to a minimum, not only to avoid merging problems with long-lived feature branches, but also to make up for easier and faster code reviews.

Code reviews will guarantee only quality code is merged to the trunk and will allow for very early defect detection.

Scaled Trunk-Based Development

With Scale TBD, continuous integration is guaranteed, parallel development is supported, and quality is ensured with simple code reviews. It allows for quicker iterations with fewer errors, and it's always deployable with very little branch management.

Own it!

It goes without saying that each team and/or product might warrant different needs in a branching model. Teams should take extra care choosing one.

Whichever branching model is chosen, it is very (!) important that it's crystal clear to every team member what are the rules and steps in the workflow. Without it, any model will fail to bring out the best of the team and the product.

Try Reviewpad
Disrupting how software developers collaborate