Windows: Clean up documentation (#36684)

This PR includes:
- Further cleanup of BOTMETA.yml
- Cleanup of author github handles
- Use of proper booleans
- One-line license statement
- Copyright format statement
- Smaller cleanups

lib/ansible/modules/windows/win_iis_webapppool.py

@@ -1,33 +1,18 @@
 #!/usr/bin/python
 # -*- coding: utf-8 -*-
 
-# (c) 2015, Henrik Wallström <henrik@wallstroms.nu>
-#
-# This file is part of Ansible
-#
-# Ansible is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ansible is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
+# Copyright: (c) 2015, Henrik Wallström <henrik@wallstroms.nu>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
 ANSIBLE_METADATA = {'metadata_version': '1.1',
                     'status': ['preview'],
                     'supported_by': 'community'}
 
-
 DOCUMENTATION = r'''
 ---
 module: win_iis_webapppool
 version_added: "2.0"
-short_description: configures an IIS Web Application Pool
+short_description: Configure IIS Web Application Pools
 description:
   - Creates, removes and configures an IIS Web Application Pool.
 options:
@@ -59,26 +44,21 @@ options:
   name:
     description:
       - Name of the application pool.
-    required: true
+    required: yes
   state:
-    choices:
-      - present
-      - absent
-      - stopped
-      - started
-      - restarted
+    choices: [ absent, present, restarted, started, stopped ]
     default: present
     description:
       - The state of the application pool.
-      - If C(present) will ensure the app pool is configured and exists.
       - If C(absent) will ensure the app pool is removed.
-      - If C(stopped) will ensure the app pool exists and is stopped.
-      - If C(started) will ensure the app pool exists and is started.
+      - If C(present) will ensure the app pool is configured and exists.
       - If C(restarted) will ensure the app pool exists and will restart, this
         is never idempotent.
+      - If C(started) will ensure the app pool exists and is started.
+      - If C(stopped) will ensure the app pool exists and is stopped.
 author:
-  - "Henrik Wallström (@henrikwallstrom)"
-  - "Jordan Borean (@jborean93)"
+- Henrik Wallström (@henrikwallstrom)
+- Jordan Borean (@jborean93)
 '''
 
 EXAMPLES = r'''
@@ -107,7 +87,7 @@ EXAMPLES = r'''
     name: AppPool
     attributes:
       managedRuntimeVersion: v4.0
-      autoStart: false
+      autoStart: no
 
 # Note this format style has been deprecated, please use the newer dict style instead
 - name: change application pool attributes using older string style
@@ -122,7 +102,7 @@ EXAMPLES = r'''
     state: started
     attributes:
       managedRuntimeVersion: v4.0
-      autoStart: false
+      autoStart: no
 
 # In the below example we are setting attributes in child element processModel
 # https://www.iis.net/configreference/system.applicationhost/applicationpools/add/processmodel