Tidy up validate-modules:doc-required-mismatch (#1415)

* Tidy up validate-modules ignores doc-required-mismatch

* Tidy up validate-modules ignores doc-required-mismatch - update on 2.11

* Fixed chengelog frag

* rolledback removal of parameter from cloud/smartos/vmadm.py

* removed changelog frag for the rollback

* Update plugins/modules/cloud/smartos/vmadm.py

Co-authored-by: Felix Fontein <felix@fontein.de>

* Revert "removed changelog frag for the rollback"

This reverts commit 56a02ead3b.

* suggestion from PR

* yet another PR suggestion

Co-authored-by: Felix Fontein <felix@fontein.de>

plugins/modules/storage/glusterfs/gluster_peer.py

@@ -21,22 +21,23 @@ description:
 author: Sachidananda Urs (@sac)
 options:
     state:
-       choices: ["present", "absent"]
-       default: "present"
-       description:
+        choices: ["present", "absent"]
+        default: "present"
+        description:
           - Determines whether the nodes should be attached to the pool or
             removed from the pool. If the state is present, nodes will be
             attached to the pool. If state is absent, nodes will be detached
             from the pool.
-       required: true
+        type: str
     nodes:
-       description:
+        description:
           - List of nodes that have to be probed into the pool.
-       required: true
+        required: true
+        type: list
     force:
-       type: bool
-       default: false
-       description:
+        type: bool
+        default: false
+        description:
           - Applicable only while removing the nodes from the pool. gluster
             will refuse to detach a node from the pool if any one of the node
             is down, in such cases force can be used.

plugins/modules/storage/ibm/ibm_sa_domain.py

@@ -26,7 +26,6 @@ options:
     state:
         description:
             - The desired state of the domain.
-        required: true
         default: "present"
         choices: [ "present", "absent" ]
     ldap_id:

plugins/modules/storage/ibm/ibm_sa_host.py

@@ -25,7 +25,6 @@ options:
     state:
         description:
             - Host state.
-        required: true
         default: "present"
         choices: [ "present", "absent" ]
     cluster:

plugins/modules/storage/ibm/ibm_sa_host_ports.py

@@ -26,7 +26,6 @@ options:
     state:
         description:
             - Host ports state.
-        required: true
         default: "present"
         choices: [ "present", "absent" ]
     iscsi_name:

plugins/modules/storage/ibm/ibm_sa_pool.py

@@ -25,7 +25,6 @@ options:
     state:
         description:
             - Pool state.
-        required: true
         default: "present"
         choices: [ "present", "absent" ]
     size:

plugins/modules/storage/ibm/ibm_sa_vol.py

@@ -29,7 +29,6 @@ options:
     state:
         description:
             - Volume state.
-        required: true
         default: "present"
         choices: [ "present", "absent" ]
     size:

plugins/modules/storage/ibm/ibm_sa_vol_map.py

@@ -30,7 +30,7 @@ options:
         description:
             - When the state is present the volume is mapped.
                 When the state is absent, the volume is meant to be unmapped.
-        required: true
+
     cluster:
         description:
             - Maps the volume to a cluster.

plugins/modules/storage/zfs/zfs_delegate_admin.py

@@ -30,7 +30,6 @@ options:
       - Whether to allow (C(present)), or unallow (C(absent)) a permission.
       - When set to C(present), at least one "entity" param of I(users), I(groups), or I(everyone) are required.
       - When set to C(absent), removes permissions from the specified entities, or removes all permissions if no entity params are specified.
-    required: true
     choices: [ absent, present ]
     default: present
   users: