From 7332fd0930e42ab277804e7236c952e69564e571 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Wed, 12 Nov 2025 12:49:32 -0600 Subject: [PATCH 1/2] 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/2] 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).