From f6b0a114922ef85f53e5fb40e95760b419295ccb Mon Sep 17 00:00:00 2001
From: Florent Poinsard <florent.poinsard@outlook.fr>
Date: Wed, 9 Oct 2024 09:51:17 -0600
Subject: [PATCH] add disclaimer in the documentation about vitess
 compatibility

Signed-off-by: Florent Poinsard <florent.poinsard@outlook.fr>
---
 docs/api/index.html                             | 8 +++++++-
 pkg/apis/planetscale/v2/vitesskeyspace_types.go | 9 ++++++++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/api/index.html b/docs/api/index.html
index ef1035c9..317830b5 100644
--- a/docs/api/index.html
+++ b/docs/api/index.html
@@ -6552,7 +6552,13 @@ <h3 id="planetscale.com/v2.VitessKeyspaceTemplateImages">VitessKeyspaceTemplateI
 <p>
 <p>VitessKeyspaceTemplateImages specifies user-definable container images to
 use for this keyspace. The images defined here by the user will override
-those defined at the top-level in VitessCluster.spec.images</p>
+those defined at the top-level in VitessCluster.spec.images.</p>
+<p>While this field allows you to set a different set of Vitess version for
+some components of Vitess than the version defined at the top level, it
+is important to note that Vitess only ensure compatibility between one
+version and the next and previous one. For instance: N is only compatible
+with N+1 and N-1. Do be careful when specifying multiple versions across
+your cluster so that they respect this compatibility rule.</p>
 <p>Note: this structure is a copy of VitessKeyspaceImages, once we have gotten
 rid of MysqldImage and replaced it by MysqldImageNew (planned for v2.15), we
 should be able to remove VitessKeyspaceTemplateImages entirely and just use
diff --git a/pkg/apis/planetscale/v2/vitesskeyspace_types.go b/pkg/apis/planetscale/v2/vitesskeyspace_types.go
index 370e17c9..5f1558f9 100644
--- a/pkg/apis/planetscale/v2/vitesskeyspace_types.go
+++ b/pkg/apis/planetscale/v2/vitesskeyspace_types.go
@@ -189,7 +189,14 @@ type VitessKeyspaceTemplate struct {
 
 // VitessKeyspaceTemplateImages specifies user-definable container images to
 // use for this keyspace. The images defined here by the user will override
-// those defined at the top-level in VitessCluster.spec.images
+// those defined at the top-level in VitessCluster.spec.images.
+//
+// While this field allows you to set a different set of Vitess version for
+// some components of Vitess than the version defined at the top level, it
+// is important to note that Vitess only ensure compatibility between one
+// version and the next and previous one. For instance: N is only compatible
+// with N+1 and N-1. Do be careful when specifying multiple versions across
+// your cluster so that they respect this compatibility rule.
 //
 // Note: this structure is a copy of VitessKeyspaceImages, once we have gotten
 // rid of MysqldImage and replaced it by MysqldImageNew (planned for v2.15), we