diff --git a/docs/operator-manual/applicationset/Generators-Cluster.md b/docs/operator-manual/applicationset/Generators-Cluster.md
index 1e52088c5f..5dcaca75e3 100644
--- a/docs/operator-manual/applicationset/Generators-Cluster.md
+++ b/docs/operator-manual/applicationset/Generators-Cluster.md
@@ -152,14 +152,14 @@ spec:
   - clusters:
       selector:
         matchLabels:
-          argocd.argoproj.io/kubernetes-version: 1.28
+          argocd.argoproj.io/kubernetes-version: 1.28.1
         # matchExpressions are also supported.
         #matchExpressions:
         #  - key: argocd.argoproj.io/kubernetes-version
         #    operator: In
         #    values:
-        #      - "1.27"
-        #      - "1.28"
+        #      - "1.27.1"
+        #      - "1.28.1"
 ```
 
 ### Pass additional key-value pairs via `values` field
diff --git a/docs/operator-manual/upgrading/3.3-3.4.md b/docs/operator-manual/upgrading/3.3-3.4.md
index d24d2327a2..c8d62d8b08 100644
--- a/docs/operator-manual/upgrading/3.3-3.4.md
+++ b/docs/operator-manual/upgrading/3.3-3.4.md
@@ -1,5 +1,27 @@
 # v3.3 to 3.4
 
+## Breaking Changes
+
+### Cluster version format change
+
+**New behavior:**
+
+3.4 now stores the cluster version in a more detailed format, `Major.Minor.Patch` compared to the previous format `Major.Minor`. 
+
+This change is aligning how ArgoCD interprets K8s cluster version with how Helm `3.19.0` and above interprets it.    
+
+This change makes it easier to compare versions and to support future features. It also allows for more accurate version comparisons and better compatibility with future Kubernetes releases. 
+
+This change was also back ported to Argo CD `3.3.3`.
+
+**Impact:**
+
+Application Sets with Cluster Generators, that fetch clusters based on their Kubernetes version and use `argocd.argoproj.io/auto-label-cluster-info` on the cluster secret, need to be updated to use `argocd.argoproj.io/kubernetes-version` with the `Major.Minor.Patch` format instead of the previous `Major.Minor` format. 
+More details [here](../applicationset/Generators-Cluster.md#fetch-clusters-based-on-their-k8s-version).
+
+Additionally, API, UI and CLI commands that retrieve cluster information now return the version in the `Major.Minor.Patch` format.
+
+
 ## Behavioral Improvements / Fixes
 
 ### Applications with `Missing` health status