Firmware Versioning

FujiNet Firmware Versioning

Version numbers are manually increased by developers in the include/version.h file. This doc describes what constitutes a change to the version number and the process for pushing a new release build.

Semantic Versioning

Rules for version bumps go here

Initiate a Release Build

Release builds are triggered by pushing a Tag in the form of vXX.XX.XX where X contains digits (the version number). Any tag beginning with v will trigger a release. The build system uses the Tag description as a display for the end user to show any relevant important changes to the end user. This description should be succinct describing the most important notable changes.

In addition to the description, a change log is created in the release that can be referenced. This change log contains a bulleted list of the commit messages since the last release. It is important for developers to describe commit changes clearly so that end users and other developers can understand what changes have been made. Non descriptive messages such as Tweaks should not be used.

Before initiating a release build, the developer tasked with starting the release build should update and commit include/version.h as needed. Pushing a new release Tag can be done with git from the command line like this:

git tag -a v1.0.0 -m "Short and sweet release description"
git push origin v1.0.0