Docs touchups

awx_collection/plugins/modules/tower_workflow_job_template.py

@@ -20,8 +20,9 @@ author: "John Westcott IV (@john-westcott-iv)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower workflow job templates.
 description:
-    - Create, update, or destroy Ansible Tower workflow job templates. See
+    - Create, update, or destroy Ansible Tower workflow job templates.
-      U(https://www.ansible.com/tower) for an overview.
+    - Replaces the deprecated tower_workflow_template module.
+    - Use the tower_workflow_job_template_node after this to build the workflow's graph.
 options:
     name:
       description:
@@ -30,7 +31,7 @@ options:
       type: str
     new_name:
       description:
-        - Setting this option will change the existing name (looked up via the name field.
+        - Setting this option will change the existing name.
       required: False
       type: str
     description:
@@ -40,7 +41,7 @@ options:
       type: str
     extra_vars:
       description:
-        - NO DESCRIPTION GIVEN IN THE TOWER API
+        - Variables which will be made available to jobs ran inside the workflow.
       required: False
       type: dict
     organization:
@@ -57,7 +58,7 @@ options:
       type: bool
     ask_variables_on_launch:
       description:
-        - Prompt user for (extra_vars) on launch.
+        - Prompt user for C(extra_vars) on launch.
       required: False
       type: bool
     inventory:

awx_collection/plugins/modules/tower_workflow_job_template_node.py

@@ -20,8 +20,12 @@ author: "John Westcott IV (@john-westcott-iv)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower workflow job template nodes.
 description:
-    - Create, update, or destroy Ansible Tower workflow job template nodes. See
+    - Create, update, or destroy Ansible Tower workflow job template nodes.
-      U(https://www.ansible.com/tower) for an overview.
+    - Use this to build a graph for a workflow, which dictates what the workflow runs.
+    - Replaces the deprecated tower_workflow_template module schema command.
+    - You can create nodes first, and link them afterwards, and not worry about ordering.
+      For failsafe referencing of a node, specify identifier, WFJT, and organization.
+      With those specified, you can choose to modify or not modify any other parameter.
 options:
     extra_data:
       description:
@@ -182,20 +186,20 @@ from ..module_utils.tower_api import TowerModule
 def main():
     # Any additional arguments that are not fields of the item can be added here
     argument_spec = dict(
-        extra_data=dict(required=False, type='dict'),
-        inventory=dict(required=False, type='str'),
-        scm_branch=dict(required=False, type='str'),
-        job_type=dict(required=False, type='str', choices=['run', 'check']),
-        job_tags=dict(required=False, type='str'),
-        skip_tags=dict(required=False, type='str'),
-        limit=dict(required=False, type='str'),
-        diff_mode=dict(required=False, type='bool'),
-        verbosity=dict(required=False, type='str', choices=['0', '1', '2', '3', '4', '5']),
-        workflow_job_template=dict(required=True, type='str', aliases=['workflow']),
-        organization=dict(required=False, type='str'),
-        unified_job_template=dict(required=False, type='str'),
-        all_parents_must_converge=dict(required=False, type='bool'),
         identifier=dict(required=True, type='str'),
+        workflow_job_template=dict(required=True, type='str', aliases=['workflow']),
+        organization=dict(type='str'),
+        extra_data=dict(type='dict'),
+        inventory=dict(type='str'),
+        scm_branch=dict(type='str'),
+        job_type=dict(type='str', choices=['run', 'check']),
+        job_tags=dict(type='str'),
+        skip_tags=dict(type='str'),
+        limit=dict(type='str'),
+        diff_mode=dict(type='bool'),
+        verbosity=dict(type='str', choices=['0', '1', '2', '3', '4', '5']),
+        unified_job_template=dict(type='str'),
+        all_parents_must_converge=dict(type='bool'),
         success_nodes=dict(type='list', elements='str'),
         always_nodes=dict(type='list', elements='str'),
         failure_nodes=dict(type='list', elements='str'),