From 9a7d53fd3cf2ff58fdc17ba6ea3fb5d64cf4c52b Mon Sep 17 00:00:00 2001 From: Ben Leggett <854255+bleggett@users.noreply.github.com> Date: Tue, 26 Nov 2024 11:01:49 -0500 Subject: [PATCH] Make compat version support more explicit (#15997) * Make compat version support more explicit Signed-off-by: Benjamin Leggett * Update content/en/docs/setup/additional-setup/compatibility-versions/index.md Co-authored-by: Craig Box * Update content/en/docs/setup/additional-setup/compatibility-versions/index.md --------- Signed-off-by: Benjamin Leggett Co-authored-by: Craig Box --- .../setup/additional-setup/compatibility-versions/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/setup/additional-setup/compatibility-versions/index.md b/content/en/docs/setup/additional-setup/compatibility-versions/index.md index 8301b8513b..23cbe0bfec 100644 --- a/content/en/docs/setup/additional-setup/compatibility-versions/index.md +++ b/content/en/docs/setup/additional-setup/compatibility-versions/index.md @@ -40,9 +40,9 @@ $ helm install ... --set compatibilityVersion={{< istio_previous_version >}} ## When should I use compatibility versions? -Compatibility versions are recommended to be used only when an incompatibility is found, rather than as the default. -Each compatibility version will only persist for a few releases, so eventually you will need to migrate to the new behavior. -Currently, each compatibility version is intended to remain for at least two versions, though this is subject to change. +Compatibility versions should be used only when an incompatibility between releases exists, as a temporary measure. You should plan to migrate to the new behavior as soon as practical. + +Compatibility versions for a release will be removed, and will no longer be supported, when the release they refer to reaches end-of-life. Refer to the [current Istio release support status chart](/docs/releases/supported-releases/#support-status-of-istio-releases) for the status of specific releases. To help detect if a compatibility version should be used, `istioctl x precheck` can be used with the `--from-version` flag. For instance, if you are upgrading from version {{< istio_previous_version >}}: