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
Update semver.md #547
base: master
Are you sure you want to change the base?
Update semver.md #547
Conversation
Clarified points 4 and 5.
If my product is not "ready for the public to use", why would I burn through SemVer version numbers at all? If I am not publishing the product, a build number should suffice. |
@jwdonahue I appreciate your comment but I'm not entirely sure how it relates to the PR. Regarding version numbers, you're welcome to use any format but this change only entails the details of items 4 and 5. Other items describe using notations such as "-prerelease" and build numbers. In fact I'm using a package that uses "canary-xyz123" as a version number. Again, this PR is only to clarify and improve items 4 and 5. There is still some leeway given with the verbiage, such as using the words "It is not recommended for the public". Just because someone does not recommend the usage doesn't mean it's off limits. We just want to point out that certain guarantees in code quality are not provided. |
@ajbogh wrote:
That's already obvious in the current spec. It does not require added emphasis. |
Closing & re-opening to trigger CI |
Something feels off with this. I'm not sure that recommendations for and against public use should form part of SemVer. After all, if something is not recommended for public use, why publish it? |
There are quite a few popular projects that avoid going 1.0 for the sake of flexibility to make breaking changes. Kubernetes was on 0.X for a while and used in production by hundreds of thousands. Hugo is another example, it is on 0.81 now and millions use it. |
Something feels off with that. |
Clarified points 4 and 5.
Fixes #490