From 8390b311f88ae97857aa64a916c8322763e83df6 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Fri, 5 Dec 2025 09:05:46 -0600 Subject: [PATCH] Update the versioning policy to retain the minor breaking scheme indefinitely (#16710) --- docs/reference/policies/versioning.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/reference/policies/versioning.md b/docs/reference/policies/versioning.md index db8adbcef..a978a7723 100644 --- a/docs/reference/policies/versioning.md +++ b/docs/reference/policies/versioning.md @@ -1,14 +1,13 @@ # Versioning +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. -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. +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).