Semantic Versioning

Software versioning is the most widely adopted scheme for assigning unique version version numbers to software releases.

We practice Semantic Versioning for all projects (e.g. GitHub Tags/Releases, Helm Charts, Terraform Modules, Docker Images).

Image credit: [Gopher Academy]( credit: Gopher Academy


Generally, all of our versions follow this convention: X.Y.Z (e.g. 1.2.3). Sometimes, we’ll use this format: X.Y.Z-branch when we need to disambiguate between versions existing in multiple branches.

We use GitHub tags & releases for all versioning. All docker images follow the same convention.



We always start projects off at 0.1.0. This is our first release of any project. While we try to keep our interfaces stable, as long as X=0, it indicates that our code does not yet have a stable API and may vary radically between minor releases.


As soon as our code reaches 1.X.Y, the interface should be relatively stable - that is not changing much between minor releases.