DEV Community

Discussion on: When is it right to change the version number of a project?

belinde profile image
Franco Traversaro

The first number, in my opinion, changes when a backward incompatible change happens. The second, when you introduce new features. The third, when you're just fixing a bug.

ghost profile image
Ghost Author

That's a really good way of thinking about it, I feel. I might give that a test run for a while, and see see how it goes.

groogs profile image
Greg MacLellan

This is a pretty non-technical-user-friendly scheme. The first number may also change for marketing reasons, eg: make a big splash about a really major new feature (or often, a new feature that replaces an older feature).

I also like to have a 4th number on the end which is just a build number, incremented every build by your CI system. You might end up with versions looking like:

Along the way there were builds like,, but those were not final, and never saw the light of day outside dev/QA.

Using that it's trivially easy to see the difference between (which had that one tiny mistake) and the actual release version of There's literally never a conversation that involves a question like "is this the actual 1.0.0??"