From 8a3dcb0b696fbdc5351d864536ce37368f436b55 Mon Sep 17 00:00:00 2001 From: Tim Sneath Date: Fri, 31 Jul 2026 09:59:12 -0700 Subject: [PATCH 1/2] Revise project status and versioning information Updated project status to reflect 1.x release and production readiness. Added semantic versioning details and release notes information. --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f507e3c9e..90e45ff11 100644 --- a/README.md +++ b/README.md @@ -89,4 +89,14 @@ Contributions to `container` are welcome and encouraged. Please see our [main co ## Project Status -The container project is currently under active development. Its stability, both for consuming the project as a Swift package and the `container` tool, is only guaranteed within patch versions, such as between 0.1.1 and 0.1.2. Minor version releases may include breaking changes until we reach a 1.0.0 release. +The container project is under active development and has reached a 1.x release. +It is considered production-quality: the tool and its Swift package APIs are +suitable for production use on supported systems. + +The project follows [semantic versioning](https://semver.org) for both the +`container` tool and its Swift package APIs: breaking changes are +reserved for major version releases, while minor and patch releases remain +backward compatible. + +Release notes flag breaking CLI changes with ⌨️ and breaking API changes with 👩‍💻. +See the [releases page](https://github.com/apple/container/releases) for details. From ab80124f1c8c41a507535bbbd7bef4d526bdc4b4 Mon Sep 17 00:00:00 2001 From: Tim Sneath Date: Mon, 3 Aug 2026 11:58:19 -0700 Subject: [PATCH 2/2] [docs]: update project status section for clarity and conciseness --- README.md | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 90e45ff11..1f71d8911 100644 --- a/README.md +++ b/README.md @@ -89,14 +89,6 @@ Contributions to `container` are welcome and encouraged. Please see our [main co ## Project Status -The container project is under active development and has reached a 1.x release. -It is considered production-quality: the tool and its Swift package APIs are -suitable for production use on supported systems. +The container project is under active development and has reached a 1.x release. It is considered production-quality: both the tool and its Swift package APIs are suitable for production use on supported systems. -The project follows [semantic versioning](https://semver.org) for both the -`container` tool and its Swift package APIs: breaking changes are -reserved for major version releases, while minor and patch releases remain -backward compatible. - -Release notes flag breaking CLI changes with ⌨️ and breaking API changes with 👩‍💻. -See the [releases page](https://github.com/apple/container/releases) for details. +Within a major release, compatibility is maintained at the XPC API level, so older clients can communicate with a newer `container-apiserver`, and vice versa. Minor versions correspond to regular releases (currently monthly), while patch versions are reserved for fixes and hotfixes. See the [releases page](https://github.com/apple/container/releases) for details of recent updates. \ No newline at end of file