Multiple doc fix 3 (#5238)

* multiple modules 2: fixed markups in doc

* multiple modules 3: fixed markups in doc

* fixed yaml

* Update plugins/modules/cloud/misc/proxmox_template.py

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

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

plugins/modules/monitoring/nagios.py

@@ -23,11 +23,11 @@ description:
   - The C(nagios) module is not idempotent.
   - All actions require the I(host) parameter to be given explicitly. In playbooks you can use the C({{inventory_hostname}}) variable to refer
     to the host the playbook is currently running on.
-  - You can specify multiple services at once by separating them with commas, .e.g., C(services=httpd,nfs,puppet).
+  - You can specify multiple services at once by separating them with commas, .e.g. I(services=httpd,nfs,puppet).
   - When specifying what service to handle there is a special service value, I(host), which will handle alerts/downtime/acknowledge for the I(host itself),
-    e.g., C(service=host). This keyword may not be given with other services at the same time.
+    e.g., I(service=host). This keyword may not be given with other services at the same time.
     I(Setting alerts/downtime/acknowledge for a host does not affect alerts/downtime/acknowledge for any of the services running on it.)
-    To schedule downtime for all services on particular host use keyword "all", e.g., C(service=all).
+    To schedule downtime for all services on particular host use keyword "all", e.g., I(service=all).
 options:
   action:
     description:
@@ -52,17 +52,17 @@ options:
   author:
     description:
      - Author to leave downtime comments as.
-       Only usable with the C(downtime) and C(acknowledge) action.
+       Only used when I(action) is C(downtime) or C(acknowledge).
     type: str
     default: Ansible
   comment:
     description:
-     - Comment for C(downtime) and C(acknowledge)action.
+     - Comment when I(action) is C(downtime) or C(acknowledge).
     type: str
     default: Scheduling downtime
   start:
     description:
-      - When downtime should start, in time_t format (epoch seconds).
+      - When downtime should start, in C(time_t) format (epoch seconds).
     version_added: '0.2.0'
     type: str
   minutes:
@@ -73,9 +73,10 @@ options:
     default: 30
   services:
     description:
-      - What to manage downtime/alerts for. Separate multiple services with commas.
-        C(service) is an alias for C(services).
-        B(Required) option when using the C(downtime), C(acknowledge), C(forced_check), C(enable_alerts), and C(disable_alerts) actions.
+      - >
+        What to manage downtime/alerts for. Separate multiple services with commas.
+        I(service) is an alias for I(services).
+        B(Required) option when I(action) is one of: C(downtime), C(acknowledge), C(forced_check), C(enable_alerts), C(disable_alerts).
     aliases: [ "service" ]
     type: str
   servicegroup:

plugins/modules/monitoring/spectrum_device.py

@@ -29,7 +29,7 @@ options:
         type: str
         description:
             - SNMP community used for device discovery.
-            - Required when C(state=present).
+            - Required when I(state=present).
         required: true
     landscape:
         type: str
@@ -38,7 +38,6 @@ options:
             - Landscape handle of the SpectroServer to which add or remove the device.
     state:
         type: str
-        required: false
         description:
             - On C(present) creates the device when it does not exist.
             - On C(absent) removes the device when it exists.
@@ -49,7 +48,7 @@ options:
         aliases: [ oneclick_url ]
         required: true
         description:
-            - HTTP, HTTPS URL of the Oneclick server in the form (http|https)://host.domain[:port]
+            - HTTP, HTTPS URL of the Oneclick server in the form C((http|https)://host.domain[:port]).
     url_username:
         type: str
         aliases: [ oneclick_user ]
@@ -63,17 +62,14 @@ options:
         description:
             - Oneclick user password.
     use_proxy:
-        required: false
         description:
-            - if C(false), it will not use a proxy, even if one is defined in an environment
-                variable on the target hosts.
+            - if C(false), it will not use a proxy, even if one is defined in an environment variable on the target hosts.
         default: true
         type: bool
     validate_certs:
-        required: false
         description:
             - If C(false), SSL certificates will not be validated. This should only be used
-                on personally controlled sites using self-signed certificates.
+              on personally controlled sites using self-signed certificates.
         default: true
         type: bool
     agentport: