[PR #6683/eff0cb0e backport][stable-7] Use semantic markup (modules r-s) (#6707)

Use semantic markup (modules r-s) (#6683)

* Use semantic markup.

* Use 'ignore:' for alias reference.

* Ignore sanity errors for older ansible-core versions.

* Improve markup for RHSM modules.

Co-authored-by: Pino Toscano <ptoscano@redhat.com>

* 'ignore:' is no longer needed.

* E() now works better.

---------

Co-authored-by: Pino Toscano <ptoscano@redhat.com>
(cherry picked from commit eff0cb0ed9)

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

plugins/modules/rocketchat.py

@@ -29,8 +29,8 @@ options:
   domain:
     type: str
     description:
-      - The domain for your environment without protocol. (i.e.
-        C(example.com) or C(chat.example.com))
+      - The domain for your environment without protocol. (For example
+        V(example.com) or V(chat.example.com).)
     required: true
   token:
     type: str
@@ -42,7 +42,7 @@ options:
   protocol:
     type: str
     description:
-      - Specify the protocol used to send notification messages before the webhook url. (i.e. http or https)
+      - Specify the protocol used to send notification messages before the webhook URL (that is, V(http) or V(https)).
     default: https
     choices:
       - 'http'
@@ -54,7 +54,7 @@ options:
   channel:
     type: str
     description:
-      - Channel to send the message to. If absent, the message goes to the channel selected for the I(token)
+      - Channel to send the message to. If absent, the message goes to the channel selected for the O(token)
         specified during the creation of webhook.
   username:
     type: str
@@ -70,18 +70,20 @@ options:
     type: str
     description:
       - Emoji for the message sender. The representation for the available emojis can be
-        got from Rocket Chat. (for example :thumbsup:) (if I(icon_emoji) is set, I(icon_url) will not be used)
+        got from Rocket Chat.
+      - For example V(:thumbsup:).
+      - If O(icon_emoji) is set, O(icon_url) will not be used.
   link_names:
     type: int
     description:
-      - Automatically create links for channels and usernames in I(msg).
+      - Automatically create links for channels and usernames in O(msg).
     default: 1
     choices:
       - 1
       - 0
   validate_certs:
     description:
-      - If C(false), SSL certificates will not be validated. This should only be used
+      - If V(false), SSL certificates will not be validated. This should only be used
         on personally controlled sites using self-signed certificates.
     type: bool
     default: true