From f427164d9945ad65cfc5760f69ee1dc1e888ac57 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Fri, 7 Mar 2025 11:12:07 -0600 Subject: [PATCH] Update versioning policy (#11666) See https://github.com/astral-sh/uv/issues/10808#issuecomment-2671235395 --- docs/reference/policies/versioning.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/reference/policies/versioning.md b/docs/reference/policies/versioning.md index 743c619cd..03304edb1 100644 --- a/docs/reference/policies/versioning.md +++ b/docs/reference/policies/versioning.md @@ -3,8 +3,12 @@ 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 does not yet have a stable API; once uv's API is stable (v1.0.0), the versioning scheme will -adhere to [Semantic Versioning](https://semver.org/). +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's changelog can be [viewed on GitHub](https://github.com/astral-sh/uv/blob/main/CHANGELOG.md).