Update stackable helper to set the operator version too

Author: NickLarsenNZ

antora-playbook.yml

@@ -30,7 +30,7 @@ antora:
     - require: '@sntke/antora-mermaid-extension'
       mermaid_library_url: https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs
       script_stem: mermaid-scripts
-    - ./supplemental-ui/lib/stackable-operator-branch.js
+    - ./supplemental-ui/lib/stackable-operator-helpers.js
 content:
   sources:
     - url: .

local-antora-playbook.yml

@@ -15,7 +15,7 @@ antora:
     - require: '@sntke/antora-mermaid-extension'
       mermaid_library_url: https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs
       script_stem: mermaid-scripts
-    - ./supplemental-ui/lib/stackable-operator-branch.js
+    - ./supplemental-ui/lib/stackable-operator-helpers.js
 content:
   sources:
     - url: ./

modules/guides/pages/deploy-operators-and-csi-drivers-separately.adoc

@@ -5,7 +5,7 @@
 :commons-operator-values: https://github.com/stackabletech/commons-operator/blob/{stackable-operator-branch}/deploy/helm/commons-operator/values.yaml
 :nifi-operator-values: https://github.com/stackabletech/nifi-operator/blob/{stackable-operator-branch}/deploy/helm/nifi-operator/values.yaml
 // TODO: Is there a way to make the links above go to the right place?
-// Eg: we can search/replace "0.0.0-dev" with the release, but in the above case we would need to replace "main".
+// Eg: we can search/replace "{stackable-operator-version}" with the release, but in the above case we would need to replace "main".
 
 Operators can be installed on nodes separate from where the workloads will run.
 There is a caveat when it comes to two operators: Secret Operator and Listener Operator.
@@ -160,10 +160,10 @@ Secret Operator::
 --
 NOTE: This operator uses a specific values file.
 
-[source,bash]
+[source,bash,subs="attributes"]
 ----
 helm install secret-operator \
-    --version=0.0.0-dev \
+    --version={stackable-operator-version} \
     --values=stackable-secret-operator.yaml \
     oci://oci.stackable.tech/sdp-charts/secret-operator
 ----
@@ -175,10 +175,10 @@ Listener Operator::
 --
 NOTE: This operator uses a specific values file.
 
-[source,bash]
+[source,bash,subs="attributes"]
 ----
 helm install listener-operator \
-    --version=0.0.0-dev \
+    --version={stackable-operator-version} \
     --values=stackable-listener-operator.yaml \
     oci://oci.stackable.tech/sdp-charts/listener-operator
 ----
@@ -190,15 +190,15 @@ Remaining operators::
 --
 NOTE: These operators use the same values file.
 
-[source,bash]
+[source,bash,subs="attributes"]
 ----
 helm install commons-operator \
-    --version=0.0.0-dev \
+    --version={stackable-operator-version} \
     --values=stackable-operators.yaml \
     oci://oci.stackable.tech/sdp-charts/commons-operator
 
 helm install nifi-operator \
-    --version=0.0.0-dev \
+    --version={stackable-operator-version} \
     --values=stackable-operators.yaml \
     oci://oci.stackable.tech/sdp-charts/nifi-operator
 ----

only-dev-antora-playbook.yml

@@ -15,7 +15,7 @@ antora:
     - require: '@sntke/antora-mermaid-extension'
       mermaid_library_url: https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs
       script_stem: mermaid-scripts
-    - ./supplemental-ui/lib/stackable-operator-branch.js
+    - ./supplemental-ui/lib/stackable-operator-helpers.js
 content:
   sources:
     - url: ./

…ntal-ui/lib/stackable-operator-branch.js …tal-ui/lib/stackable-operator-helpers.jssupplemental-ui/lib/stackable-operator-branch.js renamed to supplemental-ui/lib/stackable-operator-helpers.js supplemental-ui/lib/stackable-operator-branch.js renamed to supplemental-ui/lib/stackable-operator-helpers.js

@@ -1,7 +1,8 @@
 // This is so we can map `nightly` (from the release dropdown) to the `main`
-// branch, and `YY.M` -> `release-YY.M`.
+// branch and 0.0.0-dev version, and `YY.M` to the `release-YY.M` branch and
+// YY.M.0 version.
 //
-// In adocs, you can access it via {stackable-operator-branch}.
+// In adocs, you can access it via {stackable-operator-branch} and {stackable-operator-version}.
 //
 // Useful links:
 // Extensions: https://docs.antora.org/antora/latest/extend/extensions/
@@ -10,17 +11,19 @@ module.exports.register = function () {
   this.once('contentClassified', ({ playbook, contentCatalog }) => {
     contentCatalog.getComponents().forEach((component) => {
       component.versions.forEach((componentVersion) => {
-        const operatorBranch = componentVersion.version === 'nightly'
-          ? 'main'
-          : `release-${componentVersion.version}`
+        const operatorInfo = componentVersion.version === 'nightly'
+          ? { branch: 'main', version: '0.0.0-dev' }
+          // TODO: Be clever about the patch level (eg: pull from the release repo: https://github.com/stackabletech/release/blob/main/releases.yaml)
+          : { branch: `release-${componentVersion.version}`, version: `${componentVersion.version}.0` }
 
         // Not sure why we need a new object, but _they_ do it.
         // See: https://github.com/couchbase/docs-site/blob/b7db9602fc035945ace72e3152e9fb83ef7cba51/lib/antora-component-version-rank.js
         componentVersion.asciidoc = {
           ...componentVersion.asciidoc,
           attributes: {
             ...componentVersion.asciidoc.attributes,
-            'stackable-operator-branch': operatorBranch
+            'stackable-operator-branch': operatorInfo.branch,
+            'stackable-operator-version': operatorInfo.version,
           }
         }
       })

truly-local-playbook.yml

@@ -15,7 +15,7 @@ antora:
     - require: '@sntke/antora-mermaid-extension'
       mermaid_library_url: https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs
       script_stem: mermaid-scripts
-    - ./supplemental-ui/lib/stackable-operator-branch.js
+    - ./supplemental-ui/lib/stackable-operator-helpers.js
 content:
   sources:
     - url: ./