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/clustering/consul.py

@@ -49,86 +49,65 @@ options:
           - Unique name for the service on a node, must be unique per node,
             required if registering a service. May be omitted if registering
             a node level check
-        required: false
     service_id:
         description:
           - the ID for the service, must be unique per node, defaults to the
             service name if the service name is supplied
-        required: false
         default: service_name if supplied
     host:
         description:
           - host of the consul agent defaults to localhost
-        required: false
         default: localhost
     port:
         description:
           - the port on which the consul agent is running
-        required: false
         default: 8500
     scheme:
         description:
           - the protocol scheme on which the consul agent is running
-        required: false
         default: http
         version_added: "2.1"
     validate_certs:
         description:
           - whether to verify the tls certificate of the consul agent
-        required: false
-        default: True
+        type: bool
+        default: 'yes'
         version_added: "2.1"
     notes:
         description:
           - Notes to attach to check when registering it.
-        required: false
-        default: None
     service_port:
         description:
           - the port on which the service is listening. Can optionally be supplied for
             registration of a service, i.e. if service_name or service_id is set
-        required: false
-        default: None
     service_address:
         description:
           - the address to advertise that the service will be listening on.
             This value will be passed as the I(Address) parameter to Consul's
             U(/v1/agent/service/register) API method, so refer to the Consul API
             documentation for further details.
-        required: false
-        default: None
         version_added: "2.1"
     tags:
         description:
           - a list of tags that will be attached to the service registration.
-        required: false
-        default: None
     script:
         description:
           - the script/command that will be run periodically to check the health
             of the service. Scripts require an interval and vise versa
-        required: false
-        default: None
     interval:
         description:
           - the interval at which the service check will be run. This is a number
             with a s or m suffix to signify the units of seconds or minutes e.g
             15s or 1m. If no suffix is supplied, m will be used by default e.g.
             1 will be 1m. Required if the script param is specified.
-        required: false
-        default: None
     check_id:
         description:
           - an ID for the service check, defaults to the check name, ignored if
             part of a service definition.
-        required: false
-        default: None
     check_name:
         description:
           - a name for the service check, defaults to the check id. required if
             standalone, ignored if part of service definition.
-        required: false
-        default: None
     ttl:
         description:
           - checks can be registered with a ttl instead of a script and interval
@@ -138,29 +117,21 @@ options:
             Similar to the interval this is a number with a s or m suffix to
             signify the units of seconds or minutes e.g 15s or 1m. If no suffix
             is supplied, m will be used by default e.g. 1 will be 1m
-        required: false
-        default: None
     http:
         description:
           - checks can be registered with an http endpoint. This means that consul
             will check that the http endpoint returns a successful http status.
             Interval must also be provided with this option.
-        required: false
-        default: None
         version_added: "2.0"
     timeout:
         description:
           - A custom HTTP check timeout. The consul default is 10 seconds.
             Similar to the interval this is a number with a s or m suffix to
             signify the units of seconds or minutes, e.g. 15s or 1m.
-        required: false
-        default: None
         version_added: "2.0"
     token:
         description:
           - the token key indentifying an ACL rule set. May be required to register services.
-        required: false
-        default: None
 """
 
 EXAMPLES = '''