docs(getting-started): update stackablectl op install output (#838)

* docs(getting-started): update stackablectl op install output

* chore(getting-started): add warning to generated script

* chore(shellcheck): defer fixing the warning for now

* fix(getting-started): use correct version for rendered file

Author: NickLarsenNZ

docs/modules/zookeeper/examples/getting_started/code/getting_started.sh

@@ -1,6 +1,19 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# DO NOT EDIT THE SCRIPT
+# Instead, update the j2 template, and regenerate it for dev:
+# cat <<EOF | jinja2 --format yaml getting_started.sh.j2 -o getting_started.sh
+# helm:
+#   repo_name: stackable-dev
+#   repo_url: https://repo.stackable.tech/repository/helm-dev/
+# versions:
+#   commons: 0.0.0-dev
+#   listener: 0.0.0-dev
+#   secret: 0.0.0-dev
+#   zookeeper: 0.0.0-dev
+# EOF
+
 # This script contains all the code snippets from the guide, as well as some assert tests
 # to test if the instructions in the guide work. The user *could* use it, but it is intended
 # for testing only.
@@ -112,6 +125,7 @@ kubectl describe configmap simple-znode
 
 cm_output=$(get_configmap)
 
+# shellcheck disable=SC2181 # wont't fix this now, but ideally we should enable bash strict mode so we can avoid success checks.
 if [[ $? == 0 ]]; then
   echo "ConfigMap retrieved."
 else

docs/modules/zookeeper/examples/getting_started/code/getting_started.sh.j2

@@ -1,6 +1,19 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# DO NOT EDIT THE SCRIPT
+# Instead, update the j2 template, and regenerate it for dev:
+# cat <<EOF | jinja2 --format yaml getting_started.sh.j2 -o getting_started.sh
+# helm:
+#   repo_name: stackable-dev
+#   repo_url: https://repo.stackable.tech/repository/helm-dev/
+# versions:
+#   commons: 0.0.0-dev
+#   listener: 0.0.0-dev
+#   secret: 0.0.0-dev
+#   zookeeper: 0.0.0-dev
+# EOF
+
 # This script contains all the code snippets from the guide, as well as some assert tests
 # to test if the instructions in the guide work. The user *could* use it, but it is intended
 # for testing only.
@@ -112,6 +125,7 @@ kubectl describe configmap simple-znode
 
 cm_output=$(get_configmap)
 
+# shellcheck disable=SC2181 # wont't fix this now, but ideally we should enable bash strict mode so we can avoid success checks.
 if [[ $? == 0 ]]; then
   echo "ConfigMap retrieved."
 else

docs/modules/zookeeper/examples/getting_started/code/install_output.txt

@@ -1,4 +1,4 @@
-[INFO ] Installing commons operator in version 0.0.0-dev
-[INFO ] Installing secret operator in version 0.0.0-dev
-[INFO ] Installing listener operator in version 0.0.0-dev
-[INFO ] Installing zookeeper operator in version 0.0.0-dev
+Installed commons=0.0.0-dev operator
+Installed secret=0.0.0-dev operator
+Installed listener=0.0.0-dev operator
+Installed zookeeper=0.0.0-dev operator

docs/modules/zookeeper/examples/getting_started/code/install_output.txt.j2

@@ -1,4 +1,4 @@
-[INFO ] Installing commons operator in version {{ versions.commons }}
-[INFO ] Installing secret operator in version {{ versions.secret }}
-[INFO ] Installing listener operator in version {{ versions.listener }}
-[INFO ] Installing zookeeper operator in version {{ versions.zookeeper }}
+Installed commons={{ versions.commons }} operator
+Installed secret={{ versions.secret }} operator
+Installed listener={{ versions.listener }} operator
+Installed zookeeper={{ versions.zookeeper }} operator