SemVer: Don’t be afraid of Major Versions

There isn’t anything BIG enough to warrant a major release.

And with that, I set out to explore my options…

Vanity Numbers (marketing.major.minor.patch)

This isn’t without its challenges. For example, a library may be at and a large external event triggers a change the version 2 of the library. If it is merely a vanity number, should the new version be or Note that this doesn’t work with some tools such as NPM.

Prerelease Versions (major.minor.patch+something)

Still waiting for marketing to approve your version 2 release, then use a prerelease flow. Instead of jumping straight to 2.0.0, use the following progression and precedence: 2.0.0-alpha.1 > 2.0.0-beta.1 > 2.0.0-rc.1 > 2.0.0-rc.2.

Public Versions (Foo 2, 1.36.2)

This approach assumes the two versions become decoupled. Unfortunately, this is never the case and the history of Angular releases should be enough to warn us against it. The gist is that a package having a version of 1.36.2 or 3.0.1 does not make sense when the package is publicly being called version 2 in marketing.

Calendar Versions (2020.3.1)

For some, this is equivalent to saying I give up on semantic versioning. For others, it is an acknowledgment that semantic versioning is nearly impossible for their specific case. The calendar approach completely removes marketing and pushes the challenges on the user.

Cheap Major Versions (123.11.2)

This may be the least bad approach for most libraries. In reality, 99% of us maintain a package where no one cares about marketing or the fact that we are on a major version in the triple digits. It’s cheap, easy, and has the best usability for developers and their tools.


Semantic versioning is not without flaws. Consider that one developer’s bugfix may be another’s breaking change.

Why are we relying on fallible humans to examine an API and encode an assertion about its backwards compatibility into a number?

Or as another stated in their critique of semantic versioning:

Basically, Romantic Versioning, not Semantic Versioning.



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store