From bc2a63c4150581073d5b69c5284f38fe2f2fa0df Mon Sep 17 00:00:00 2001
From: John R Barker <john@johnrbarker.com>
Date: Thu, 9 Mar 2017 16:20:25 +0000
Subject: [PATCH] Fix invalid fields in module DOCUMENATION (#22297)

* fix module doc fields

* More module docs corrections

* More module docs corrections

* More module docs corrections

* More module docs corrections

* correct aliases

* Review comments

* Must quote ':'

* More authors

* Use suboptions:

* restore type: bool

* type should be in the same place

* More tidyups

* authors

* Use suboptions

* revert

* remove duplicate author

* More issues post rebase
---
 .../modules/web_infrastructure/ansible_tower/tower_credential.py | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_group.py      | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_host.py       | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_inventory.py  | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_job_cancel.py | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_job_launch.py | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_job_list.py   | 1 +
 .../web_infrastructure/ansible_tower/tower_job_template.py       | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_job_wait.py   | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_label.py      | 1 +
 .../web_infrastructure/ansible_tower/tower_organization.py       | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_project.py    | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_role.py       | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_team.py       | 1 +
 .../modules/web_infrastructure/ansible_tower/tower_user.py       | 1 +
 15 files changed, 15 insertions(+)

diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_credential.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_credential.py
index 9b17e0bd8d..57f66f4bac 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_credential.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_credential.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_credential
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower credential.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_group.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_group.py
index 738b5ea071..bb0bafc94d 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_group.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_group.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_group
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower group.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_host.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_host.py
index 12562e999b..77819f4446 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_host.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_host.py
@@ -24,6 +24,7 @@ DOCUMENTATION = '''
 ---
 module: tower_host
 version_added: "2.3"
+author: "Wayne Witzel III (@wwitzel3)"
 short_description: create, update, or destroy Ansible Tower host.
 description:
     - Create, update, or destroy Ansible Tower hosts. See
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_inventory.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_inventory.py
index 5eac8724c2..71983e0414 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_inventory.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_inventory.py
@@ -24,6 +24,7 @@ DOCUMENTATION = '''
 ---
 module: tower_inventory
 version_added: "2.3"
+author: "Wayne Witzel III (@wwitzel3)"
 short_description: create, update, or destroy Ansible Tower inventory.
 description:
     - Create, update, or destroy Ansible Tower inventories. See
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_cancel.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_cancel.py
index 2f0042bce0..70b2f9ec2b 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_cancel.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_cancel.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_job_cancel
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: Cancel an Ansible Tower Job.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_launch.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_launch.py
index 3a7679d9d1..4d1d5fdf85 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_launch.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_launch.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_job_launch
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: Launch an Ansible Job.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_list.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_list.py
index 5c9c82f7f3..3b32b82bb3 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_list.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_list.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_job_list
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: List Ansible Tower jobs.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_template.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_template.py
index d50f0fce16..f06e84267c 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_template.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_template.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_job_template
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower job_template.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_wait.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_wait.py
index 166d0a277f..c1e9db7748 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_wait.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_job_wait.py
@@ -24,6 +24,7 @@ DOCUMENTATION = '''
 ---
 module: tower_job_wait
 version_added: "2.3"
+author: "Wayne Witzel III (@wwitzel3)"
 short_description: Wait for Ansible Tower job to finish.
 description:
     - Wait for Ansible Tower job to finish and report success or failure. See
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_label.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_label.py
index dc6b232582..4f8403bab0 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_label.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_label.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_label
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower label.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_organization.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_organization.py
index 406c380434..721e139770 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_organization.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_organization.py
@@ -24,6 +24,7 @@ DOCUMENTATION = '''
 ---
 module: tower_organization
 version_added: "2.3"
+author: "Wayne Witzel III (@wwitzel3)"
 short_description: create, update, or destroy Ansible Tower organizations
 description:
     - Create, update, or destroy Ansible Tower organizations. See
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_project.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_project.py
index dda5435bd6..0079fa4a51 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_project.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_project.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_project
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower projects
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_role.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_role.py
index 47982f67d7..4538bb1900 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_role.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_role.py
@@ -24,6 +24,7 @@ DOCUMENTATION = '''
 ---
 module: tower_role
 version_added: "2.3"
+author: "Wayne Witzel III (@wwitzel3)"
 short_description: create, update, or destroy Ansible Tower role.
 description:
     - Create, update, or destroy Ansible Tower roles. See
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_team.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_team.py
index 9dd1da9586..29a3cd8dc1 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_team.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_team.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_team
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower team.
 description:
diff --git a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_user.py b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_user.py
index ad879a7329..85d3ed6e63 100644
--- a/lib/ansible/modules/web_infrastructure/ansible_tower/tower_user.py
+++ b/lib/ansible/modules/web_infrastructure/ansible_tower/tower_user.py
@@ -23,6 +23,7 @@ ANSIBLE_METADATA = {'status': ['preview'],
 DOCUMENTATION = '''
 ---
 module: tower_user
+author: "Wayne Witzel III (@wwitzel3)"
 version_added: "2.3"
 short_description: create, update, or destroy Ansible Tower user.
 description: