From 7332fd0930e42ab277804e7236c952e69564e571 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Wed, 12 Nov 2025 12:49:32 -0600 Subject: [PATCH 1/3] Update the versioning policy to retain the minor breaking scheme --- docs/reference/policies/versioning.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/reference/policies/versioning.md b/docs/reference/policies/versioning.md index 03304edb1829a..23bd2bc151837 100644 --- a/docs/reference/policies/versioning.md +++ b/docs/reference/policies/versioning.md @@ -1,14 +1,15 @@ # Versioning +uv is widely used in production and is considered "stable" software. + uv uses a custom versioning scheme in which the minor version number is bumped for breaking changes, and the patch version number is bumped for bug fixes, enhancements, and other non-breaking changes. +However, we value the ability to iterate on new features quickly and gather changes that _could_ be +breaking into clearly marked releases. -uv is widely used in production. However, we value the ability to iterate on new features quickly -and gather changes that _could_ be breaking into clearly marked releases. - -Once uv v1.0.0 is released, the versioning scheme will adhere to -[Semantic Versioning](https://semver.org/). There is not a particular goal that must be achieved for -uv to reach this milestone. +uv may change this versioning scheme at a future date, e.g., by adopting [Semantic +Versioning](https://semver.org/), but a significant change to the policy for breaking versions will +be indicated by a bump of the major version number. uv's changelog can be [viewed on GitHub](https://github.com/astral-sh/uv/blob/main/CHANGELOG.md). From 1137eca43c16fdbc1a9cc1159becde1a6283ea65 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Wed, 12 Nov 2025 13:00:57 -0600 Subject: [PATCH 2/3] v3 :D --- docs/reference/policies/versioning.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/reference/policies/versioning.md b/docs/reference/policies/versioning.md index 23bd2bc151837..01f29ed6ba329 100644 --- a/docs/reference/policies/versioning.md +++ b/docs/reference/policies/versioning.md @@ -1,15 +1,13 @@ # Versioning -uv is widely used in production and is considered "stable" software. +uv is widely used in production and is considered stable software. uv uses a custom versioning scheme in which the minor version number is bumped for breaking changes, and the patch version number is bumped for bug fixes, enhancements, and other non-breaking changes. -However, we value the ability to iterate on new features quickly and gather changes that _could_ be -breaking into clearly marked releases. -uv may change this versioning scheme at a future date, e.g., by adopting [Semantic -Versioning](https://semver.org/), but a significant change to the policy for breaking versions will -be indicated by a bump of the major version number. +The care we take in backwards-incompatible changes is proportional to the expected real-world +impact, not a function of arbitrary version numbering policies. We value the ability to iterate on +new features quickly and gather changes that _could_ be breaking into clearly marked releases. uv's changelog can be [viewed on GitHub](https://github.com/astral-sh/uv/blob/main/CHANGELOG.md). From 559dc413e83934948aec0b4a1c9fa7126fd90e53 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Mon, 24 Nov 2025 08:49:51 -0600 Subject: [PATCH 3/3] Update docs/reference/policies/versioning.md --- docs/reference/policies/versioning.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/policies/versioning.md b/docs/reference/policies/versioning.md index 01f29ed6ba329..16d01801b4c1a 100644 --- a/docs/reference/policies/versioning.md +++ b/docs/reference/policies/versioning.md @@ -1,6 +1,6 @@ # Versioning -uv is widely used in production and is considered stable software. +uv is widely used in production and is stable software. uv uses a custom versioning scheme in which the minor version number is bumped for breaking changes, and the patch version number is bumped for bug fixes, enhancements, and other non-breaking changes.