Code version change “rules” [closed]

by

Version numbering policies can be a bit crazy at times (see Version numbers and JSR277, or Oracle, with its Oracle Database 11g Release 2: 11.2.0.1.0.
See also Software Versioning is Ridiculous).

But you can start by looking at the Eclipse Version Number policy as a good start.
If you really think you need more than three digits, this V.R.M.F. Maintenance Stream Delivery Vehicle terminology explanation is also interesting, but more so for post 1.0 software programs, where fix pack and interim fixes are in order.

  1. How to upgrade versions correctly

“Ship it already”: 1.0.0

Also known as the “1.oh-oh” version. At least, it is out there, and you can begin to get feedback and iterate fast.

  1. Which is a good starting version number

0.x if major features are still missing; 1.0.0 if the major features are there.

  1. Is it ok to make numbers above 10? like v1.25 or v2.2.30?

Yes, but I would say only for large projects with a lifespan over several years (a decade usually)

Note that “correctly” (while being described at length in Semantic Versioning 2.0.0) can also be guided by more pragmatic factors:

See the announcement for Git 1.9 (January 2014):

A release candidate Git v1.9-rc2 is now available for testing at the usual places.

I’ve heard rumours that various third-party tools do not like the two-digit version numbers (e.g. “Git 2.0”) and started barfing left and right when the users install v1.9-rc1.
While it is tempting to laugh at them for their sloppy assumption, I am also practical and
do not mind calling the upcoming release v1.9.0 to help them.

If we go that route (and I am inclined to go that route at this moment), the versioning scheme will be:

  • The next release candidate will be v1.9.0-rc3, not v1.9-rc3;
  • The first maintenance release for v1.9.0 will be v1.9.1 (and Nth one be v1.9.N); and
  • The feature release after v1.9.0 will be either v1.10.0 or v2.0.0, depending on how big the feature jump we are looking at.

Update Feb. 2019: semver itself is about to evolve (again, after semver2).
See “What’s next for SemVer“, and semver/semver/CONTRIBUTING.

More Related Contents:

  1. When should you branch?
  2. How can I use ClearCase to “add to source control …” recursively?
  3. Why is a 3-way merge advantageous over a 2-way merge?
  4. How do you maintain development code and production code? [closed]
  5. Using IPython / Jupyter Notebooks Under Version Control
  6. ClearCase advantages/disadvantages [closed]
  7. What is the cleverest use of source repository that you have ever seen?
  8. IntelliJ IDEA 9/10, what folders to check into (or not check into) source control?
  9. What’s the best three-way merge tool? [closed]
  10. Storing third-party libraries in source control
  11. Mercurial for Beginners: The Definitive Practical Guide
  12. Named Branches vs Multiple Repositories
  13. Mercurial — revert back to old version and continue from there
  14. Is version control (ie. Subversion) applicable in document tracking? [closed]
  15. Mercurial Subrepos – How do you create them and how do they work?
  16. How to edit incorrect commit message in Mercurial? [duplicate]
  17. Mercurial: How to ignore changes to a tracked file
  18. How do I perform a recursive checkout using ClearCase?
  19. Source Control – Distributed Systems vs. Non Distributed – What’s the difference?
  20. Is there a way to keep Hudson / Jenkins configuration files in source control?
  21. Branching Strategies [closed]
  22. Comparison between Centralized and Distributed Version Control Systems [closed]
  23. Can you “ignore” a file in Perforce?
  24. Mercurial: Merging one file between branches in one repo
  25. What is the difference between hg forget and hg remove?
  26. How often to commit changes to source control? [closed]
  27. Do you continue development in a branch or in the trunk? [closed]
  28. TFS 2017 – how build/deliver only changed files?
  29. How to find untracked files in a Perforce tree? (analogue of svn status)
  30. What is the difference between all the different types of version control?

Leave a Comment