From 17613ede565f01c1cec3388587542b7efbb14cb5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Mon, 25 Apr 2022 19:10:21 +0200 Subject: [PATCH 1/3] Loosen requirement for a major version bump --- specification/versioning-and-stability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/versioning-and-stability.md b/specification/versioning-and-stability.md index b42bec11e0a..d0e3ba9b944 100644 --- a/specification/versioning-and-stability.md +++ b/specification/versioning-and-stability.md @@ -254,7 +254,7 @@ When a signal becomes stable, the version MUST be bumped to match the other stab ### Major version bump -Major version bumps MUST occur when there is a breaking change to a stable interface, the removal of a deprecated signal, or a drop in support for a language or runtime version. +Major version bumps MUST occur when there is a breaking change to a stable interface, the removal of a deprecated signal. Major version bumps SHOULD NOT occur for changes which do not result in a drop in support of some form. ### Minor version bump From b13196b6616fab4369ca1255ac7c504894050445 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Thu, 28 Apr 2022 09:00:40 +0200 Subject: [PATCH 2/3] Update versioning-and-stability.md --- specification/versioning-and-stability.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/specification/versioning-and-stability.md b/specification/versioning-and-stability.md index d0e3ba9b944..7d3094da8d2 100644 --- a/specification/versioning-and-stability.md +++ b/specification/versioning-and-stability.md @@ -24,6 +24,7 @@ * [Major version bump](#major-version-bump) * [Minor version bump](#minor-version-bump) * [Patch version bump](#patch-version-bump) + * [Language version support](#language-version-support) - [Long Term Support](#long-term-support) * [API support](#api-support) * [SDK Support](#sdk-support) @@ -281,6 +282,14 @@ Currently, the OpenTelemetry project does NOT have plans to backport bug and sec Security and bug fixes MAY only be applied to the latest minor version. We are committed to making it feasible for end users to stay up to date with the latest version of the OpenTelemetry SDK. +### Language version support + +Each language implementation SHOULD define +how the removal of a supported language/runtime version +affects its versioning. +As a rule of thumb, +it SHOULD take the recommended approach in the given ecosystem + ## Long Term Support ![long term support](../internal/img/long-term-support.png) From 97928c4907068504f28bf0e2c79e5a3fe571dbf8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Robert=20Paj=C4=85k?= Date: Thu, 28 Apr 2022 23:22:31 +0200 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Yuri Shkuro --- specification/versioning-and-stability.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/versioning-and-stability.md b/specification/versioning-and-stability.md index 7d3094da8d2..3a039c77f1c 100644 --- a/specification/versioning-and-stability.md +++ b/specification/versioning-and-stability.md @@ -255,7 +255,7 @@ When a signal becomes stable, the version MUST be bumped to match the other stab ### Major version bump -Major version bumps MUST occur when there is a breaking change to a stable interface, the removal of a deprecated signal. +Major version bumps MUST occur when there is a breaking change to a stable interface or a deprecated signal is removed. Major version bumps SHOULD NOT occur for changes which do not result in a drop in support of some form. ### Minor version bump @@ -288,7 +288,7 @@ Each language implementation SHOULD define how the removal of a supported language/runtime version affects its versioning. As a rule of thumb, -it SHOULD take the recommended approach in the given ecosystem +it SHOULD follow the conventions in the given ecosystem. ## Long Term Support