From d57f2ab49629aebc0892fadb65e135a8e40dc31c Mon Sep 17 00:00:00 2001
From: Maximilian Meister <maximilian.meister@pm.me>
Date: Wed, 14 Apr 2021 19:27:02 +0200
Subject: [PATCH] Document usage of workflow job template nodes with approvals

Fixes #8777
---
 .../tower_workflow_job_template_node.py       | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/awx_collection/plugins/modules/tower_workflow_job_template_node.py b/awx_collection/plugins/modules/tower_workflow_job_template_node.py
index bb3c64fcab..b878af8d53 100644
--- a/awx_collection/plugins/modules/tower_workflow_job_template_node.py
+++ b/awx_collection/plugins/modules/tower_workflow_job_template_node.py
@@ -174,6 +174,54 @@ EXAMPLES = '''
     organization: Default
     success_nodes:
       - my-first-node
+
+- name: Create workflow with 2 Job Templates and an approval node in between
+  block:
+  - name: Create a workflow job template
+    tower_workflow_job_template:
+      name: my-workflow-job-template
+      ask_scm_branch_on_launch: true
+      organization: Default
+
+  - name: Create 1st node
+    tower_workflow_job_template_node:
+      identifier: my-first-node
+      workflow_job_template: my-workflow-job-template
+      unified_job_template: some_job_template
+      organization: Default
+
+  - name: Create 2nd approval node
+    tower_workflow_job_template_node:
+      identifier: my-second-approval-node
+      workflow_job_template: my-workflow-job-template
+      organization: Default
+      approval_node:
+        description: "Do this?"
+        name: my-second-approval-node
+        timeout: 3600
+
+  - name: Create 3rd node
+    tower_workflow_job_template_node:
+      identifier: my-third-node
+      workflow_job_template: my-workflow-job-template
+      unified_job_template: some_other_job_template
+      organization: Default
+
+  - name: Link 1st node to 2nd Approval node
+    tower_workflow_job_template_node:
+      identifier: my-first-node
+      workflow_job_template: my-workflow-job-template
+      organization: Default
+      success_nodes:
+        - my-second-approval-node
+
+  - name: Link 2nd Approval Node 3rd node
+    tower_workflow_job_template_node:
+      identifier: my-second-approval-node
+      workflow_job_template: my-workflow-job-template
+      organization: Default
+      success_nodes:
+        - my-third-node
 '''
 
 from ..module_utils.tower_api import TowerAPIModule