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).