What version numbering scheme do you recommend? [closed]

Question

My question is, which version-naming scheme should be used for what type of project.

Very common is major.minor.fix, but even this can lead to 4 number (i.e. Firefox 2.0.0.16). Some have a model that odd numbers indicate developer-versions and even numbers stable releases. And all sorts of additions can enter the mix, like -dev3, -rc1, SP2 etc.

Exists reasons to prefer one scheme over another and should different type of projects (i.e. Open Source vs. Closed Source) have different version naming schemes?

Outcry

This should either be closed as (far) too opinion-based or at least moved to softwareengineering.stackexchange.com where questions about development philosophy are on-topic, unlike here. – Maloy

Answer 1

There are two good answers for this (plus a lot of personal preferences; see gizmo's comment on religious wars).

For public applications, the standard Major.Minor.Revision.Build works best IMO - public users can easily tell what version of the program they have and, to some degree, how far out of date their version is.

For in house applications, where the users never asked for the application, the deployment is handled by IT, and users will be calling the help desk, I found the Year.Month.Day.Build to work better in a lot of situations. This version number can thus be decoded to provide more useful information to the help desk than the public versioning number scheme.

However at the end of the day I would make one recommendation above all else - use a system you can keep consistent. If there is a system that you can setup/script your compiler to automatically use everytime, use that.

The worst thing that can happen is you releasing binaries with the same version number as the previous ones - I've recently been dealing with automated network error reports (someone elses application), and came to the conclusion that the Year.Month.Day.Build version numbers shown in the core dumps where not even remotely up to date with the application itself (the application itself used a splash screen with the real numbers - which of course where not drawn from the binary as one might assume). The result is I have no way of knowing if crash dumps are coming from a 2 year old binary (what the version number indicates) or a 2 month old binary, and thus no way of getting the right source code (no source control either!)

Gattis

Answer 2

I'm a big fan of Semantic versioning

As many others have commented this uses the X.Y.Z format and gives good reasons as to why.

Minutiae

Answer 3

Here's what we use in our company: Major.Minor.Patch version.Build Number .

The Major change involves a full release cycle, including marketing involvement etc. This number is controled by forces outside of R&D (for example, in one of the places I worked, Marketing decided that our next version would be '11' - to match a competitor. We were at version 2 at the time :)).

Minor is changed when a new feature or a major behavior change is added to the product.

Patch version goes up by one every time a patch is officially added to the version, usually including bug fixes only.

Build Version is used when a special version is released for a customer, usually with a bug fix specific to him. Usually that fix will be rolled up for the next patch or minor version (and Product Management usually marks the bug as "will be released for patch 3" in our tracking system).

Phagocytosis

Answer 4

Our R&D department uses 1.0.0.0.0.000: MAJOR.minor.patch.audience.critical_situation.build

Please, please, don't do that.

Iconoclasm

Glad to be of service, although I might argue that pointing out bad practices can be valuable. Of course this one's pretty subjective. – Iconoclasm

Answer 5

This kind of question is more about religion war than objective aspects. There is always tons of pros and cons against a numbering scheme or another. All what people could (or should) give you is the scheme they used and why they choose it.

On my side, I use a X.Y.Z scheme all are numbers where:

• X indicate a change in the public API that introduce backward incompatibility
• Y indicate an addition of some features
• Z indicate a fix (either fixing a bug, either changing internal structure without impacting functionnality)

Eventually, I use "Beta N" suffix if I want some feedback from the users before an official release is done. No "RC" suffix as nobody is perfect and there will always be bugs ;-)

Pianoforte

Why don't you prefer RC over Beta for feedback? Is it because user might not know what it means? – Laundromat

Answer 6

We prefer major.minor.milestone.revision-build scheme, where:

• major: Increments upon significant architectural changes or important advancements in capabilities.
• minor: Small changes and new features that does not require architectural changes.
• milestone: Indicates stability and maturity of the code:
  • 0 for development/pre-alpha
  • 1 for alpha
  • 2 for beta
  • 3 for release candidate (RC)
  • 4 for final/production release
• revision: Indicates release, patch or bugfix number.
• build: Unique references to specific builds, or versions, of an application. Build number is a sequential integer, typically incremented at each build.

Examples:

• 1.4.2.0-798: First beta release of version 1.4, created by build number 798.
• 1.8.3.4-970: 1.8-RC4, created by build number 970.
• 1.9.4.0-986: First production release of version 1.9, created by build number 986.
• 1.9.4.2-990: Second bugfix release of version 1.9, created by build number 990.

Since prodcution releases always have 4 in their 3rd digit of version string, the digit may be removed for production releases.

Crimmer

Answer 7

I personally prefer MAJOR.MINOR.BUGFIX-SUFFIX where SUFFIX is dev for development versions (version control checkouts), rc1 / rc2 for release candidates and no suffix for release versions.

If you have suffixes for development checkouts, maybe even with the revision number, there is no need to make them even/odd to keep them apart.

Seaware

Answer 8

In the case of a library, the version number tells you about the level of compatibility between two releases, and thus how difficult an upgrade will be.

A bug fix release needs to preserve binary, source, and serialization compatibility.

Minor releases mean different things to different projects, but usually they don't need to preserve source compatibility.

Major version numbers can break all three forms.

I wrote more about the rationale here.

Leighannleighland

Answer 9

With Agile software development practices and SaaS applications, the idea of a Major vs. a Minor release has gone away - releases come out extremely frequently on a regular basis - so a release numbering scheme that relies on this distinction is no longer useful to me.

My company uses a numbering scheme that takes the last 2 digits of the year the release started followed by the release number within that year.

So, the 4th release started in 2012 would be 12.4.

You can include a "bug fix" version number after that if necessary, but ideally you are releasing frequently enough that these are not often necessary - so "12.4.2".

This is a very simple scheme and has not given us any of the problems of other release numbering schemes that I have used before.

Dasya

Answer 10

The difference between a close and open-source version number policy can also come from a commercial aspect, when the major version can reflect the year of the release for instance.

Gulgee

Answer 11

What we used to do here is major.minor.platform.fix.

major: We increase this number when saved file from this build are no longer compatible with previous build.
Exemple: Files saved in version 3.0.0.0 won't be compatible with version 2.5.0.0.

minor: We increase this number when a new feature has been added. This feature should be seen by the user. Not a hidden feature for developper. This number is reset to 0 when major is incremented.

platform: This is the platform we use for developpement.
Exemple: 1 stands for .net framework version 3.5.

fix : We increase this number when only bug fixes are included with this new version. This number is reset to 0 when major or minor is incremented.

Ossifrage

Answer 12

Simply

Major.Minor.Revision.Build

Tautomer