📖[Docs] How-to: Z-stream Automatic Updates (#1219)

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

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

@@ -0,0 +1,24 @@
+## 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:
+  source:
+    sourceType: Catalog
+    catalog:
+      packageName: argocd-operator
+      version: “~2.3" # Automatically upgrade patch releases for v2.3
+  install:
+    namespace: argocd
+    serviceAccount:
+      name: argocd-installer
+```
+
+For more information on SemVer version ranges see [version ranges](version-ranges.md)