What's the "best" way to version your product?
5 points
23 hours ago
| 7 comments
| HN
There is the classic “Major.Minor.Patch”. Maybe git sha? I see this becoming popular this year: “year.version” from folks like Neo4J and Rivian.
toast0
2 hours ago
[-]
It really depends on your release plans.

If you are actually going to (attempt to) support multiple releases, semantic major.minor.patch is very useful.

If you're really just going to support only the latest, semantic versioning is probably not so helpful, year.version is easy to figure out chronological differences with.

githash as the only version identifier is a sign that you don't intend to help users track versions. This could be the right choice if you want to release something without expectations of use.

reply
sloaken
2 hours ago
[-]
I like the classic as it provides actionable information.

Although knowing the date is nice, especially to indicate an application is dead end. But I rarely need that. When I first download it, and when I wonder ... hmm is this product ever going to be updated.

I am not sure what the value of putting the year in the version.

For my own home projects, and work pre-release, I always list the build date on the screen. Saved me more than a little frustration.

You could combine them. Either Year.Major.Minor.Patch, or the other way around. But like I said before not sure of the value.

reply
mystifyingpoi
23 hours ago
[-]
Define "best" and then define "your product". A library for a programming langugage will have very different idea about versioning than let's say, Microsoft Office.
reply
sema4hacker
21 hours ago
[-]
I developed and shipped one product with monthly releases for decades and always simply bumped the version by one: 1, 2, 3..

Anything fancier doesn't really tell you exactly what features changed when, so a table in the documentation spelled that out for each version.

reply
imperez
19 hours ago
[-]
I have an iOS app and I stick with the usual semantic version scheme. It’s easy for me to use. If I jump to a new major version it’s easy to explain to users.
reply
eternityforest
21 hours ago
[-]
I use semantic version for basically everything. Even for non-technical users, it's at least OK. Breaking changes are a pretty easy idea.

Year.version might be better for marketing though.

reply
raw_anon_1111
22 hours ago
[-]
For public consumption - year.version.

For libraries and even the internal version number of a public product like an OS release where developers still want to say.

if os.version > x:

standard semantic versioning.

reply