Bug #5387

Version number should indicate pre-release software

Added by Igal Koshevoy over 1 year ago. Updated 10 months ago.

Status:Closed Start date:11/24/2010
Priority:High Due date:
Assignee:Michael Stahnke % Done:

0%

Category:-
Target version:1.2.0
Keywords:version Affected URL:
Branch: Affected Dashboard version:1.0.5
Votes: 0

Description

The “master” branch currently contains untested, pre-release software, yet the VERSION file still says it’s “1.0.4”. Please make it very clear to the user that they’re running a pre-release of the software by setting the VERSION to something like “1.0.5pre”, “1.0.5dev”, “1.0.5edge”, etc.

History

Updated by Nigel Kersten over 1 year ago

  • Target version deleted (1.0.5)
  • Affected Dashboard version set to 1.0.5

Updated by James Turnbull over 1 year ago

  • Status changed from Unreviewed to Needs Decision
  • Assignee set to Nigel Kersten

Updated by Nigel Kersten over 1 year ago

Doesn’t this break just about every dumb packaging system that uses numeric components for versions only? Mac pkgs, gems, older Solaris etc?

Updated by Igal Koshevoy over 1 year ago

The immediate need is to inform people using the “master” branch that they’re using unreleased software, and I think changing the version string will help.

Coming up with a way to number pre-release packages is tricky. For example, Tom creates Puppet pre-release packages with names like “puppet-2.6.3-0.1” where “-0.1” is the RC1, and a “puppet-2.6.3-1” with a “-1” is the full release. For really primitive packaging systems, you may need to give up and just use a different product name and date-based numbering like “puppet_dashboard_devel-20101129.2” for the second bugfix release of that day.

It’d be ideal to devise a common solution for all the Puppet products. I don’t think that Puppet itself solves this problem well, where the “puppet.rb” version is stayed as “2.6.2” throughout the “2.6.3” development, and then became “2.6.3” when the RC1 was released — I find that misleading because the number is being changed both too late and too early.

Thoughts?

Updated by James Turnbull over 1 year ago

Except that anything but x.y.z fails for Gems…. That’s the major reason we’ve had challenges with numbering. Happy never to package for Gems of course!

Updated by Nigel Kersten over 1 year ago

  • Status changed from Needs Decision to Investigating

Updated by Krzysztof Wilczynski over 1 year ago

James Turnbull wrote:

Except that anything but x.y.z fails for Gems…. That’s the major reason we’ve had challenges with numbering. Happy never to package for Gems of course!

What about adding a special banner that people will see each time they run development and/or pre-release version … and if they do not wish to see it, then they can export (toggle?) an environment variable like i.e. DISABLE_PUPPET_DEVELOPMENT_NOTICE=1 etc :–)

I have seen at least two projects doing something like that during my “ways” with the systems …

Just an idea … :–)

KW

Updated by Michael Stahnke 11 months ago

  • Assignee changed from Nigel Kersten to Michael Stahnke
  • Keywords set to version

I’m switching to using git describe as the VERSION string. So at an official release, it will be a hard tag of X.y.z but if running out of master, it should be a bit more descriptive.

Updated by Michael Stahnke 11 months ago

  • Target version set to 1.2.0

Updated by Michael Stahnke 10 months ago

  • Status changed from Investigating to Closed

Fixed in 1.2rc1

Also available in: Atom PDF