AOE Technology RadarAOE Technology Radar

Conventional Commits

codingquality assuranceci/cd
Adopt

Conventional commits are being widely used in our teams, therefore we're changing this to adopt. Using commit messages which follow the conventional commits specification helps us to easily process changes made within a software release. It also helps to reduce confusion around commit message requirements for new team members.

The Semanticore release bot is a tool we published, which utilizes conventional commits to maintain the release notes of our software and suggests the correct version of the upcoming release.

Trial

The Conventional Commits specification is a lightweight convention on top of commit messages. It provides a small set of rules for writing commit messages and therefore creating an explicit commit history. The convention dovetails with SemVer, by describing the features, fixes, and breaking changes made in commit messages. The specification contains only 16 items that are easy to follow. The predefined structure allows everyone in the team to get a better overview of what the commit messages relates to and what part of the code a change has to do with. Some benefits of using these specifications include: the ability to automatically generate changelogs, the ability to determine a semantic version bump (based on the types of commits landed) and being able to communicate the nature of changes to teammates and stakeholders.

We use conventional commits in the team with the help of a git template. The template contains a guide of elements that are required in the specification plus some information about project specific items that should also be part of a commit, such as a ticket number.