docs: point PromotionTask users to task.outputs in examples

Builds on the explicit Stage context by folding in the approach from #6284:
each promotion-step example that references a previous step's outputs now also
carries an inline "# Or task.outputs in a (Cluster)PromotionTask" pointer, and
the remaining reference pages that use step outputs (gha-wait-for-workflow,
git-commit, jfrog-evidence, jira, oci-push, send-message) are wrapped in the
same Stage context.

Where an output reference sits inside a multi-line ${{ quote({...}) }}
expression, the inline pointer is omitted (it would break the expression); the
Stage context alone disambiguates there. Also fixes a "Promoteing" typo in the
jira example.

Closes #6275

Co-authored-by: Andres <aguido@unal.edu.co>
Signed-off-by: Eron Wright <eron.wright@akuity.io>

Author: EronWright

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/argocd-update.md

@@ -190,7 +190,7 @@ spec:
         as: commit
         config:
           path: ./out
-          message: ${{ outputs['update-image'].commitMessage }}
+          message: ${{ outputs['update-image'].commitMessage }} # Or task.outputs in a (Cluster)PromotionTask
       - uses: git-push
         config:
           path: ./out
@@ -320,7 +320,7 @@ spec:
                 team: platform
             sources:
             - repoURL: https://github.com/example/repo.git
-              desiredRevision: ${{ outputs.commit.commit }}
+              desiredRevision: ${{ outputs.commit.commit }} # Or task.outputs in a (Cluster)PromotionTask
 ```
 
 This configuration will select all Argo CD `Application` resources in the
@@ -354,7 +354,7 @@ spec:
                 - production
             sources:
             - repoURL: https://github.com/example/repo.git
-              desiredRevision: ${{ outputs.commit.commit }}
+              desiredRevision: ${{ outputs.commit.commit }} # Or task.outputs in a (Cluster)PromotionTask
 ```
 
 This configuration will select all Argo CD `Application` resources that have
@@ -394,7 +394,7 @@ spec:
                 - legacy-system
             sources:
             - repoURL: https://github.com/example/repo.git
-              desiredRevision: ${{ outputs.commit.commit }}
+              desiredRevision: ${{ outputs.commit.commit }} # Or task.outputs in a (Cluster)PromotionTask
 ```
 
 This configuration will select all Argo CD `Application` resources that:
@@ -462,7 +462,7 @@ spec:
                 deployment-group: blue
             sources:
             - repoURL: ${{ vars.gitRepo }}
-              desiredRevision: ${{ outputs.commit.commit }}
+              desiredRevision: ${{ outputs.commit.commit }} # Or task.outputs in a (Cluster)PromotionTask
 ```
 
 This configuration will update all Argo CD `Application` resources that have

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/argocd-wait.md

@@ -103,7 +103,7 @@ spec:
         as: commit
         config:
           path: ./out
-          message: ${{ outputs['update-image'].commitMessage }}
+          message: ${{ outputs['update-image'].commitMessage }} # Or task.outputs in a (Cluster)PromotionTask
       - uses: git-push
         config:
           path: ./out

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/gha-wait-for-workflow.md

@@ -124,54 +124,75 @@ Valid values for `expectedConclusion`:
 This example waits for a previously dispatched workflow to complete successfully using the new configuration format.
 
 ```yaml
-steps:
-- uses: gha-wait-for-workflow
-  config:
-    repoURL: https://github.com/myorg/my-app
-    runID: "${{ outputs['dispatch-deployment'].runID }}"
-    expectedConclusion: success
-    insecureSkipTLSVerify: false
+apiVersion: kargo.akuity.io/v1alpha1
+kind: Stage
+# ...
+spec:
+  # ...
+  promotionTemplate:
+    spec:
+      steps:
+      - uses: gha-wait-for-workflow
+        config:
+          repoURL: https://github.com/myorg/my-app
+          runID: "${{ outputs['dispatch-deployment'].runID }}" # Or task.outputs in a (Cluster)PromotionTask
+          expectedConclusion: success
+          insecureSkipTLSVerify: false
 ```
 
 ### v1.8 (Deprecated)
 
 ```yaml
-steps:
-- uses: gha-wait-for-workflow
-  config:
-    credentials:
-      secretName: github-credentials
-    owner: myorg
-    repo: my-app
-    runID: "${{ outputs['dispatch-deployment'].runID }}"
-    expectedConclusion: success
+apiVersion: kargo.akuity.io/v1alpha1
+kind: Stage
+# ...
+spec:
+  # ...
+  promotionTemplate:
+    spec:
+      steps:
+      - uses: gha-wait-for-workflow
+        config:
+          credentials:
+            secretName: github-credentials
+          owner: myorg
+          repo: my-app
+          runID: "${{ outputs['dispatch-deployment'].runID }}" # Or task.outputs in a (Cluster)PromotionTask
+          expectedConclusion: success
 ```
 
 ## Multi-Step Workflow Example
 
 This example shows how to combine `gha-dispatch-workflow` and `gha-wait-for-workflow` steps using the new configuration format:
 
 ```yaml
-steps:
-# Dispatch the workflow
-- uses: gha-dispatch-workflow
-  as: dispatch-deployment
-  config:
-    repoURL: https://github.com/example/test
-    workflowFile: test.yaml
-    ref: master
-    inputs:
-      greeting: "hola"
-    timeout: 120
-
-# Wait for the workflow to complete
-- uses: gha-wait-for-workflow
-  config:
-    repoURL: https://github.com/example/test
-    runID: "${{ outputs['dispatch-deployment'].runID }}"
-    expectedConclusion: success
-
-# Continue with other promotion steps after workflow completes...
+apiVersion: kargo.akuity.io/v1alpha1
+kind: Stage
+# ...
+spec:
+  # ...
+  promotionTemplate:
+    spec:
+      steps:
+      # Dispatch the workflow
+      - uses: gha-dispatch-workflow
+        as: dispatch-deployment
+        config:
+          repoURL: https://github.com/example/test
+          workflowFile: test.yaml
+          ref: master
+          inputs:
+            greeting: "hola"
+          timeout: 120
+
+      # Wait for the workflow to complete
+      - uses: gha-wait-for-workflow
+        config:
+          repoURL: https://github.com/example/test
+          runID: "${{ outputs['dispatch-deployment'].runID }}" # Or task.outputs in a (Cluster)PromotionTask
+          expectedConclusion: success
+
+      # Continue with other promotion steps after workflow completes...
 ```
 
 ## Migration from v1.8 to v1.9

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-commit.md

@@ -44,36 +44,43 @@ with a message from the [`kustomize-set-image` step](kustomize-set-image.md) tha
 updated the `kustomization.yaml` file, summarizing the changes made.
 
 ```yaml
-vars:
-- name: gitRepo
-  value: https://github.com/example/repo.git
-steps:
-- uses: git-clone
-  config:
-    repoURL: ${{ vars.gitRepo }}
-    checkout:
-    - commit: ${{ commitFrom(vars.gitRepo).ID }}
-      path: ./src
-    - branch: stage/${{ ctx.stage }}
-      create: true
-      path: ./out
-- uses: git-clear
-  config:
-    path: ./out
-- uses: kustomize-set-image
-  as: update-image
-  config:
-    images:
-    - image: my/image
-- uses: kustomize-build
-  config:
-    path: ./src/stages/${{ ctx.stage }}
-    outPath: ./out
-- uses: git-commit
-  config:
-    path: ./out
-    message: ${{ outputs['update-image'].commitMessage }}
-# Push, etc...
+apiVersion: kargo.akuity.io/v1alpha1
+kind: Stage
+# ...
+spec:
+  # ...
+  promotionTemplate:
+    spec:
+      vars:
+      - name: gitRepo
+        value: https://github.com/example/repo.git
+      steps:
+      - uses: git-clone
+        config:
+          repoURL: ${{ vars.gitRepo }}
+          checkout:
+          - commit: ${{ commitFrom(vars.gitRepo).ID }}
+            path: ./src
+          - branch: stage/${{ ctx.stage }}
+            create: true
+            path: ./out
+      - uses: git-clear
+        config:
+          path: ./out
+      - uses: kustomize-set-image
+        as: update-image
+        config:
+          images:
+          - image: my/image
+      - uses: kustomize-build
+        config:
+          path: ./src/stages/${{ ctx.stage }}
+          outPath: ./out
+      - uses: git-commit
+        config:
+          path: ./out
+          message: ${{ outputs['update-image'].commitMessage }} # Or task.outputs in a (Cluster)PromotionTask
+      # Push, etc...
 ```
 
 ### Composed Commit Message
@@ -94,11 +101,18 @@ commit messages when several changes are being committed together.
 :::
 
 ```yaml
-steps:
-# Update Kustomize manifests, etc...
-- uses: git-commit
-  config:
-    path: ./out
-    message: |
-      ${{ ctx.stage }}: ${{ outputs['update-image'].commitMessage }}
+apiVersion: kargo.akuity.io/v1alpha1
+kind: Stage
+# ...
+spec:
+  # ...
+  promotionTemplate:
+    spec:
+      steps:
+      # Update Kustomize manifests, etc...
+      - uses: git-commit
+        config:
+          path: ./out
+          message: |
+            ${{ ctx.stage }}: ${{ outputs['update-image'].commitMessage }} # Or task.outputs in a (Cluster)PromotionTask
 ```

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-open-pr.md

@@ -88,7 +88,7 @@ spec:
         as: open-pr
         config:
           repoURL: https://github.com/example/repo.git
-          sourceBranch: ${{ outputs.push.branch }}
+          sourceBranch: ${{ outputs.push.branch }} # Or task.outputs in a (Cluster)PromotionTask
           targetBranch: stage/${{ ctx.stage }}
       # Wait for the PR to be merged or closed...
 ```
@@ -124,7 +124,7 @@ spec:
         as: open-pr
         config:
           repoURL: https://github.com/example/repo.git
-          sourceBranch: ${{ outputs.push.branch }}
+          sourceBranch: ${{ outputs.push.branch }} # Or task.outputs in a (Cluster)PromotionTask
           targetBranch: stage/${{ ctx.stage }}
           title: Deploy to ${{ ctx.stage }}
           labels: ["infra", "needs-review"]
@@ -163,7 +163,7 @@ spec:
         as: open-pr
         config:
           repoURL: https://github.com/example/repo.git
-          sourceBranch: ${{ outputs.push.branch }}
+          sourceBranch: ${{ outputs.push.branch }} # Or task.outputs in a (Cluster)PromotionTask
           targetBranch: stage/${{ ctx.stage }}
       - if: ${{ status('open-pr') != 'Skipped' }}
         uses: git-wait-for-pr

docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-wait-for-pr.md

@@ -85,7 +85,7 @@ spec:
         config:
           repoURL: https://github.com/example/repo.git
           createTargetBranch: true
-          sourceBranch: ${{ outputs.push.branch }}
+          sourceBranch: ${{ outputs.push.branch }} # Or task.outputs in a (Cluster)PromotionTask
           targetBranch: stage/${{ ctx.stage }}
       - uses: git-wait-for-pr
         as: wait-for-pr