📖[Docs] How-to: Z-stream Automatic Updates

Signed-off-by: Per Goncalves da Silva <[email protected]>

Author: Per Goncalves da Silva

docs/drafts/how-to-z-stream-upgrades.md

@@ -0,0 +1,23 @@
+## How-to: Z-Stream Automatic Updates
+
+To restrict automatic updates to only z-stream patches and avoid breaking changes, use the `"~"` version range operator when setting the version for the desired package in Catalog source.
+
+Example:
+
+```yaml
+apiVersion: olm.operatorframework.io/v1alpha1
+kind: ClusterExtension
+metadata:
+  name: argocd
+spec:
+  installNamespace: argocd
+  source:
+    sourceType: Catalog
+    catalog:
+      packageName: argocd-operator
+      version: “~2.3" # Automatically upgrade patch releases for v2.3
+  serviceAccount:
+    name: argocd-installer
+```
+
+For more information on SemVer version ranges see [version ranges](version-ranges.md)