8000 Changing the versioning scheme · Issue #5083 · uutils/coreutils · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Changing the versioning scheme #5083

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

Open
tertsdiepraam opened this issue Jul 14, 2023 · 2 comments
Open

Changing the versioning scheme #5083

tertsdiepraam opened this issue Jul 14, 2023 · 2 comments

Comments

@tertsdiepraam
Copy link
Member

Our versioning scheme up to this point has been quite simple, we simply increment the patch number while keeping major and minor numbers at 0. At some point it will be appropriate to make a more significant bump.

For the proposals below, I'll use the letters X, Y and Z to be the major, minor and patch numbers. So a full version is X.Y.Z and we currently increment Z on each release.

We're fairly certain on one point: 1.0.0 should be tagged when we pass almost all GNU tests. It's probably not going to be 100%, but somewhere close to that. What the exact percentage will be, we'll have to decide later.

Also, we should be roughly following semver. According to semver though, 0.Y.Z is unstable and arbitrary. There are several things we could do until 1.0.0 (feel free to propose other schemes):

  • Keep incrementing Z
  • Let Y be the number of utils that pass all GNU tests and increment Z if there's no change in that number (proposed by @sylvestre)
  • Let Y be the percentage of passing GNU tests divided by 10 (so 0.3.0 passes 30% of tests) and increment Z otherwise.

The last two options have the advantage that they convey some information about the state of the project, though that meaning will also need to be explained. They are also a bit more complicated.

Once we hit 1.0.0, we will have to change the scheme regardless of what option we pick.

What are your opinions?

cc @sylvestre @cakebaker

@cakebaker
Copy link
Contributor

I would keep it simple and keep incrementing Z because from the user's perspective it probably doesn't matter how many GNU tests pass. It's either compatible with GNU coreutils or not.

@sylvestre
Copy link
Contributor

well, i don't think it is that boolean. A lot of remaining tests aren't really impacting the readiness level of our implementation.
many of them are just legacy
(i have been using it for work without any issue)

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

3 participants
0