Clean up module documentation (#36909)

* Clean up module documentation

This PR includes:
- Removal of `default: None` (and variations)
- Removal of `required: false`
- Fixing booleans and `type: bool` where required

* Fix remaining (new) validation issues

lib/ansible/modules/messaging/rabbitmq_parameter.py

@@ -26,32 +26,25 @@ options:
     description:
       - Name of the component of which the parameter is being set
     required: true
-    default: null
   name:
     description:
       - Name of the parameter being set
     required: true
-    default: null
   value:
     description:
       - Value of the parameter, as a JSON term
-    required: false
-    default: null
   vhost:
     description:
       - vhost to apply access privileges.
-    required: false
     default: /
   node:
     description:
       - erlang node name of the rabbit we wish to configure
-    required: false
     default: rabbit
     version_added: "1.2"
   state:
     description:
       - Specify if user is to be added or removed
-    required: false
     default: present
     choices: [ 'present', 'absent']
 '''

lib/ansible/modules/messaging/rabbitmq_policy.py

@@ -26,16 +26,13 @@ options:
     description:
       - The name of the policy to manage.
     required: true
-    default: null
   vhost:
     description:
       - The name of the vhost to apply to.
-    required: false
     default: /
   apply_to:
     description:
       - What the policy applies to. Requires RabbitMQ 3.2.0 or later.
-    required: false
     default: all
     choices: [all, exchanges, queues]
     version_added: "2.1"
@@ -43,21 +40,17 @@ options:
     description:
       - A regex of queues to apply the policy to.
     required: true
-    default: null
   tags:
     description:
       - A dict or string describing the policy.
     required: true
-    default: null
   priority:
     description:
       - The priority of the policy.
-    required: false
     default: 0
   node:
     description:
       - Erlang node name of the rabbit we wish to configure.
-    required: false
     default: rabbit
   state:
     description:

lib/ansible/modules/messaging/rabbitmq_queue.py

@@ -33,84 +33,67 @@ options:
             - Whether the queue should be present or absent
             - Only present implemented atm
         choices: [ "present", "absent" ]
-        required: false
         default: present
     login_user:
         description:
             - rabbitMQ user for connection
-        required: false
         default: guest
     login_password:
         description:
             - rabbitMQ password for connection
-        required: false
-        default: false
+        type: bool
+        default: 'no'
     login_host:
         description:
             - rabbitMQ host for connection
-        required: false
         default: localhost
     login_port:
         description:
             - rabbitMQ management api port
-        required: false
         default: 15672
     vhost:
         description:
             - rabbitMQ virtual host
-        required: false
         default: "/"
     durable:
         description:
             - whether queue is durable or not
-        required: false
-        choices: [ "yes", "no" ]
-        default: yes
+        type: bool
+        default: 'yes'
     auto_delete:
         description:
             - if the queue should delete itself after all queues/queues unbound from it
-        required: false
-        choices: [ "yes", "no" ]
-        default: no
+        type: bool
+        default: 'no'
     message_ttl:
         description:
             - How long a message can live in queue before it is discarded (milliseconds)
-        required: False
         default: forever
     auto_expires:
         description:
             - How long a queue can be unused before it is automatically deleted (milliseconds)
-        required: false
         default: forever
     max_length:
         description:
             - How many messages can the queue contain before it starts rejecting
-        required: false
         default: no limit
     dead_letter_exchange:
         description:
             - Optional name of an exchange to which messages will be republished if they
             - are rejected or expire
-        required: false
-        default: None
     dead_letter_routing_key:
         description:
             - Optional replacement routing key to use when a message is dead-lettered.
             - Original routing key will be used if unset
-        required: false
-        default: None
     max_priority:
         description:
             - Maximum number of priority levels for the queue to support.
             - If not set, the queue will not support message priorities.
             - Larger numbers indicate higher priority.
-        required: false
-        default: None
         version_added: "2.4"
     arguments:
         description:
             - extra arguments for queue. If defined this argument is a key/value dictionary
-        required: false
         default: {}
 '''
 

lib/ansible/modules/messaging/rabbitmq_user.py

@@ -26,20 +26,15 @@ options:
     description:
       - Name of user to add
     required: true
-    default: null
     aliases: [username, name]
   password:
     description:
       - Password of user to add.
       - To change the password of an existing user, you must also specify
         C(force=yes).
-    required: false
-    default: null
   tags:
     description:
       - User tags specified as comma delimited
-    required: false
-    default: null
   permissions:
     description:
       - a list of dicts, each dict contains vhost, configure_priv, write_priv, and read_priv,
@@ -47,18 +42,15 @@ options:
       - This option should be preferable when you care about all permissions of the user.
       - You should use vhost, configure_priv, write_priv, and read_priv options instead
         if you care about permissions for just some vhosts.
-    required: false
     default: []
   vhost:
     description:
       - vhost to apply access privileges.
       - This option will be ignored when permissions option is used.
-    required: false
     default: /
   node:
     description:
       - erlang node name of the rabbit we wish to configure
-    required: false
     default: rabbit
     version_added: "1.2"
   configure_priv:
@@ -67,7 +59,6 @@ options:
         for the specified vhost.
       - By default all actions are restricted.
       - This option will be ignored when permissions option is used.
-    required: false
     default: ^$
   write_priv:
     description:
@@ -75,7 +66,6 @@ options:
         for the specified vhost.
       - By default all actions are restricted.
       - This option will be ignored when permissions option is used.
-    required: false
     default: ^$
   read_priv:
     description:
@@ -83,18 +73,15 @@ options:
         for the specified vhost.
       - By default all actions are restricted.
       - This option will be ignored when permissions option is used.
-    required: false
     default: ^$
   force:
     description:
       - Deletes and recreates the user.
-    required: false
-    default: "no"
-    choices: [ "yes", "no" ]
+    type: bool
+    default: 'no'
   state:
     description:
       - Specify if user is to be added or removed
-    required: false
     default: present
     choices: [present, absent]
 '''

lib/ansible/modules/messaging/rabbitmq_vhost.py

@@ -26,19 +26,17 @@ options:
     description:
       - The name of the vhost to manage
     required: true
-    default: null
     aliases: [vhost]
   node:
     description:
       - erlang node name of the rabbit we wish to configure
-    required: false
     default: rabbit
     version_added: "1.2"
   tracing:
     description:
       - Enable/disable tracing for a vhost
-    default: "no"
-    choices: [ "yes", "no" ]
+    type: bool
+    default: 'no'
     aliases: [trace]
   state:
     description: