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

Must the version tags include a v? #1

Closed
dustin opened this Issue Dec 15, 2009 · 5 comments

Comments

Projects
None yet
3 participants
@dustin

dustin commented Dec 15, 2009

When tagging releases in a version control system, the tag for a version MUST be "vX.Y.Z" e.g. "v3.1.0".

I've always tagged my versions as X.Y.Z, e.g. 3.1.0. I pull that directly out with git describe for my apps to report their own versions.

@mojombo

This comment has been minimized.

Collaborator

mojombo commented Dec 17, 2009

I like having the v prepended so that version tags are clearly delineated from other stuff that might happen to start with a number. I guess it just disambiguates a little more than the straight version number by itself.

@dustin

This comment has been minimized.

dustin commented Dec 17, 2009

Could it perhaps be changed to a SHOULD with a detail of why you prefer it your way?

For three digit numbers as you have them, it seems unlikely to conflict with anything else (short of someone creating a branch with the same name as the version -- though this doesn't seem to prevent that confusion).

@mojombo

This comment has been minimized.

Collaborator

mojombo commented Dec 18, 2009

I've moved the tagging requirement into a sub-spec so you can safely ignore it and still be compliant with the main spec.

Haacked pushed a commit that referenced this issue Nov 10, 2014

Merge pull request #1 from djug/gh-pages
proofread the first part

Haacked pushed a commit that referenced this issue Dec 5, 2014

Haacked pushed a commit that referenced this issue Jan 28, 2016

Merge pull request #1 from jirikuchta/gh-pages-lang-cs-spec
lang/cs: minor grammar corrections, added missing paragraph in Why use... section
@steshaw

This comment has been minimized.

steshaw commented Aug 12, 2016

@mojombo wondering if that sub-spec is public somewheres?

@mojombo

This comment has been minimized.

Collaborator

mojombo commented Aug 12, 2016

You can see what it looked like in the 1.0.0 spec, though it was removed in later releases:

http://semver.org/spec/v1.0.0.html#tagging-specification-semvertag

This issue was closed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment