[GH-ISSUE #407] http://semver.org/ differ from semver.md, but both are 2.0.0 #1168

Closed
opened 2026-04-16 10:27:25 -05:00 by GiteaMirror · 15 comments
Owner

Originally created by @nowox on GitHub (Nov 15, 2017).
Original GitHub issue: https://github.com/semver/semver/issues/407

I see lots of differences between the http://semver.org/ website and the markdown file on this repository.

Unfortunately both information are marked with version 2.0.0. Obviously there are not the same

This is confusing, isn't ?

Originally created by @nowox on GitHub (Nov 15, 2017). Original GitHub issue: https://github.com/semver/semver/issues/407 I see lots of differences between the http://semver.org/ website and the markdown file on this repository. Unfortunately both information are marked with version 2.0.0. Obviously there are not the same This is confusing, isn't ?
GiteaMirror added the bug label 2026-04-16 10:27:25 -05:00
Author
Owner

@FichteFoll commented on GitHub (Nov 15, 2017):

The semver.org version is the canonical 2.0.0, as far as I'm concerned. This repo is the development version, which may have not received a version bump in "code" since the last releace.

Maybe you could point out the exact differences?

<!-- gh-comment-id:344757612 --> @FichteFoll commented on GitHub (Nov 15, 2017): The semver.org version is the canonical 2.0.0, as far as I'm concerned. This repo is the development version, which may have not received a version bump in "code" since the last releace. Maybe you could point out the exact differences?
Author
Owner

@nowox commented on GitHub (Nov 16, 2017):

What I was looking for is the paragraph about Git version that speaks about the leading v character before version numbers. This information is completely absent from 2.0.0 (website) but visible on the 2.0.0 (master branch)

Also I am very confused with this "development version". From your specifications, a version 2.0.0-rc or a version 2.0.0-alpha must exactly have the same features implemented because they have the same major, minor and patch version. Also the version on the development branch, let's say on Git, will still be 2.0.0 unless a new tag is created. However, new features are implemented on the master branch, so at some point a 2.0.0-10+g12abc3da version will be incompatible with 2.0.0-0+g1211aaac. How should I deal with that?

<!-- gh-comment-id:344912629 --> @nowox commented on GitHub (Nov 16, 2017): What I was looking for is the paragraph about Git version that speaks about the leading `v` character before version numbers. This information is completely absent from 2.0.0 (website) but visible on the 2.0.0 (master branch) Also I am very confused with this "development version". From your specifications, a version `2.0.0-rc` or a version `2.0.0-alpha` must exactly have the same features implemented because they have the same major, minor and patch version. Also the version on the development branch, let's say on Git, will still be `2.0.0` unless a new tag is created. However, new features are implemented on the master branch, so at some point a `2.0.0-10+g12abc3da` version will be incompatible with `2.0.0-0+g1211aaac`. How should I deal with that?
Author
Owner

@FichteFoll commented on GitHub (Nov 16, 2017):

The 2.0.0 release has been tagged on this repo as https://github.com/mojombo/semver/tree/v2.0.0. What you are talking about are pre-releases, which are also releases but not considered stable.

The version does not need to be increased with each commit because only releases need to have a version assigned to them. Anything between releases is whatever.

<!-- gh-comment-id:344958200 --> @FichteFoll commented on GitHub (Nov 16, 2017): The 2.0.0 release has been tagged on this repo as https://github.com/mojombo/semver/tree/v2.0.0. What you are talking about are pre-**releases**, which are also releases but not considered stable. The version does not need to be increased with each commit because only *releases* need to have a version assigned to them. Anything between releases is whatever.
Author
Owner

@jwdonahue commented on GitHub (Dec 6, 2017):

The working copy of the next release should be clearly marked as a prerelease version, "2.0.0-a.dev" or not have any version number in it at all. Perhaps we need some release automation to convert a place holder to whatever the next release should be? As-is, I agree with @nowox, that it is confusing.

<!-- gh-comment-id:349699184 --> @jwdonahue commented on GitHub (Dec 6, 2017): The working copy of the next release should be clearly marked as a prerelease version, "2.0.0-a.dev" or not have any version number in it at all. Perhaps we need some release automation to convert a place holder to whatever the next release should be? As-is, I agree with @nowox, that it is confusing.
Author
Owner

@variadico commented on GitHub (Jan 6, 2018):

Seems like master and the v2.0.0 tag have started differing since 2013. https://github.com/semver/semver/compare/v2.0.0...master

While I agree that not every commit should increase the version, perhaps there are some commits since 2013 that should be on the website. Specifically, I'd like to see Is "v1.2.3" a semantic version? on the website.

What's the release cycle like? Would it be too disruptive to have minor and patch releases? Not for every commit, but maybe once a year or something?

<!-- gh-comment-id:355768093 --> @variadico commented on GitHub (Jan 6, 2018): Seems like `master` and the `v2.0.0` tag have started differing since 2013. https://github.com/semver/semver/compare/v2.0.0...master While I agree that not _every_ commit should increase the version, perhaps there are some commits since 2013 that should be on the website. Specifically, I'd like to see [Is "v1.2.3" a semantic version?](https://github.com/semver/semver/blob/master/semver.md#is-v123-a-semantic-version) on the website. What's the release cycle like? Would it be too disruptive to have minor and patch releases? Not for every commit, but maybe once a year or something?
Author
Owner

@jwdonahue commented on GitHub (Jan 29, 2018):

@phyowaimg, why did you link this thread to this thread? Seems kind of pointless. Did you have another thread in mind?

<!-- gh-comment-id:361112201 --> @jwdonahue commented on GitHub (Jan 29, 2018): @phyowaimg, why did you link this thread to this thread? Seems kind of pointless. Did you have another thread in mind?
Author
Owner

@aspiers commented on GitHub (May 16, 2018):

This repository should lead by example. The whole point of SemVer is that releases can be made frequently whilst clearly communicating the relative impact of the changes in each release. So it really doesn't look good if SemVer itself is leaving years in between each release, when there are useful changes which go unreleased for a long time.

So I vote for a new release. That would minimise the confusion stated in this issue.

<!-- gh-comment-id:389474997 --> @aspiers commented on GitHub (May 16, 2018): This repository should lead by example. The whole point of SemVer is that releases can be made frequently whilst clearly communicating the relative impact of the changes in each release. So it really doesn't look good if SemVer itself is leaving years in between each release, when there are useful changes which go unreleased for a long time. So I vote for a new release. That would minimise the confusion stated in this issue.
Author
Owner

@grv87 commented on GitHub (Dec 1, 2018):

Hit this considering making PR for breaking changes (semver 3.0.0).
I agree with @aspiers that releases should be more often.
Also I see that the project would benefit from README or contribute guidelines that would describe how often and when releases are made.

<!-- gh-comment-id:443465871 --> @grv87 commented on GitHub (Dec 1, 2018): Hit this considering making PR for breaking changes (semver 3.0.0). I agree with @aspiers that releases should be more often. Also I see that the project would benefit from README or contribute guidelines that would describe how often and when releases are made.
Author
Owner

@grv87 commented on GitHub (Dec 1, 2018):

See also #454

<!-- gh-comment-id:443466649 --> @grv87 commented on GitHub (Dec 1, 2018): See also #454
Author
Owner

@grv87 commented on GitHub (Dec 2, 2018):

There is a problem regarding applying semver to itself.
Current English version is 2.0.0. There are also a lot of translations of the same version (https://semver.org/lang/fr/spec/v2.0.0.html and so on).

When exactly to bump patch field of SemVer version?

If we release 2.0.1, what should happen with these translations?
Version 2.0.1 doesn't say anything whether it was a fix in specification itself (and should be translated to other languages) or it was a typo/spelling error in English only that doesn't affect translations.

<!-- gh-comment-id:443499361 --> @grv87 commented on GitHub (Dec 2, 2018): There is a problem regarding applying semver to itself. Current English version is `2.0.0`. There are also a lot of translations of the same version (https://semver.org/lang/fr/spec/v2.0.0.html and so on). When exactly to bump patch field of SemVer version? If we release `2.0.1`, what should happen with these translations? Version `2.0.1` doesn't say anything whether it was a fix in specification itself (and should be translated to other languages) or it was a typo/spelling error in English only that doesn't affect translations.
Author
Owner

@PallHaraldsson commented on GitHub (Jan 19, 2019):

Seems like master and the v2.0.0 tag have started differing since 2013. v2.0.0...master

Both the home page and the 2.0.0 page have "Build metadata SHOULD" while master has "Build metadata MUST". a27ac08e16 (diff-55782f4857216898d46c6eca25fc5f32)

<!-- gh-comment-id:455778713 --> @PallHaraldsson commented on GitHub (Jan 19, 2019): > Seems like `master` and the `v2.0.0` tag have started differing since 2013. [v2.0.0...master](https://github.com/semver/semver/compare/v2.0.0...master) Both the home page and the 2.0.0 page have "Build metadata SHOULD" while master has "Build metadata MUST". https://github.com/semver/semver/commit/a27ac08e16898689bea9299b27462d2524cbebff#diff-55782f4857216898d46c6eca25fc5f32
Author
Owner

@yoosefi commented on GitHub (Jul 2, 2019):

very meta

<!-- gh-comment-id:507609105 --> @yoosefi commented on GitHub (Jul 2, 2019): very meta
Author
Owner

@alexandrtovmach commented on GitHub (Jun 10, 2020):

I'm going to investigate in sync script for this repos soon

<!-- gh-comment-id:642078690 --> @alexandrtovmach commented on GitHub (Jun 10, 2020): I'm going to investigate in sync script for this repos soon
Author
Owner

@alexandrtovmach commented on GitHub (Jun 10, 2020):

Thanks for report 👍 Closed in favor #573

<!-- gh-comment-id:642146388 --> @alexandrtovmach commented on GitHub (Jun 10, 2020): Thanks for report :+1: Closed in favor #573
Author
Owner

@alexandrtovmach commented on GitHub (Jun 13, 2020):

FYI, now we have GitHub Action that will automatically sync main repo with website repo on daily basis: https://github.com/semver/semver.org/pull/265

<!-- gh-comment-id:643585380 --> @alexandrtovmach commented on GitHub (Jun 13, 2020): FYI, now we have GitHub Action that will automatically sync main repo with website repo on daily basis: https://github.com/semver/semver.org/pull/265
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/semver#1168