Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix semantic versioning #3594

Closed
tresf opened this issue May 31, 2017 · 9 comments
Closed

Fix semantic versioning #3594

tresf opened this issue May 31, 2017 · 9 comments
Milestone

Comments

@tresf
Copy link
Member

tresf commented May 31, 2017

We've been using the 1.0.0-rc1 style releases, however this is not proper.

According to semantic versioning, it should be "rc.1" instead of "rc1". (e.g. 2.0.0-rc.1)

http://semver.org/spec/v2.0.0-rc.1.html

@Umcaruje
Copy link
Member

Umcaruje commented Jul 16, 2017

The RC4 release, which I've drafted right now is on a v1.2.0-rc.4 tag. I suggest we close this issue out and have correct versioning for all consecutive releases, starting from RC4.

@tresf
Copy link
Member Author

tresf commented Jul 16, 2017

Have we unit tested this against our internal comparators?

@lukas-w
Copy link
Member

lukas-w commented Jul 22, 2017

The way I understand the spec, "rc1" is not a violation. Pre-release versions may be dot-separated, but don't have to be. Dot-separated identifiers that contain letters are compared lexicographically. So rc1 < rc2 holds true. We're fine as long as we don't reach rc10.

@tresf
Copy link
Member Author

tresf commented Jul 22, 2017

Correct, we'd be betting on the chance we never hit 10, which isn't a violation, but also is not proper.

@lukas-w
Copy link
Member

lukas-w commented Jul 23, 2017

which isn't a violation, but also is not proper

Agreed.

I just wanted to share the way pre-release versions are sorted according to the specification (see point 11), because of what switching mid-release will mean: rc.4 < rc3 because rc < rc3! Better not start with RC4.

@Umcaruje
Copy link
Member

because of what switching mid-release will mean: rc.4 < rc3 because rc < rc3! Better not start with RC4.

Thanks for the insight, I reverted the change for RC4 on the draft release

@Umcaruje Umcaruje added this to the 1.3.0 milestone Jul 23, 2017
@husamalhomsi
Copy link
Member

I think we should omit the 0s to the right of the version number. They're as useless as having 0s to the right of a decimal number.
For example: 1.2.0 should be 1.2.

@tresf
Copy link
Member Author

tresf commented Aug 3, 2017

@Hussam-Eddin-Alhomsi, we increment this zero to a one when we release a patch to a stable version. This has happened every single release. Truncating the zero would be more work than what it's worth.

@Spekular
Copy link
Member

Now that #5636 is merged I think we can definitely consider this closed. If anyone disagrees please feel free to reopen w/ justification!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

5 participants