Use semantic markup (modules d-g) (#6672)

* Use semantic markup.

* 'ignore:' is no longer needed.

* E() now works better.

plugins/modules/deploy_helper.py

@@ -20,8 +20,9 @@ description:
   - The Deploy Helper manages some of the steps common in deploying software.
     It creates a folder structure, manages a symlink for the current release
     and cleans up old releases.
-  - "Running it with the I(state=query) or I(state=present) will return the C(deploy_helper) fact.
-    C(project_path), whatever you set in the I(path) parameter,
+  # TODO: convert below to RETURN documentation!
+  - "Running it with the O(state=query) or O(state=present) will return the C(deploy_helper) fact.
+    C(project_path), whatever you set in the O(path) parameter,
     C(current_path), the path to the symlink that points to the active release,
     C(releases_path), the path to the folder to keep releases in,
     C(shared_path), the path to the folder to keep shared resources in,
@@ -50,33 +51,33 @@ options:
     type: str
     description:
       - The state of the project.
-        C(query) will only gather facts,
-        C(present) will create the project I(root) folder, and in it the I(releases) and I(shared) folders,
-        C(finalize) will remove the unfinished_filename file, create a symlink to the newly
-          deployed release and optionally clean old releases,
-        C(clean) will remove failed & old releases,
-        C(absent) will remove the project folder (synonymous to the M(ansible.builtin.file) module with I(state=absent)).
+      - V(query) will only gather facts.
+      - V(present) will create the project C(root) folder, and in it the C(releases) and C(shared) folders.
+      - V(finalize) will remove the unfinished_filename file, create a symlink to the newly
+          deployed release and optionally clean old releases.
+      - V(clean) will remove failed & old releases.
+      - V(absent) will remove the project folder (synonymous to the M(ansible.builtin.file) module with O(state=absent)).
     choices: [ present, finalize, absent, clean, query ]
     default: present
 
   release:
     type: str
     description:
-      - The release version that is being deployed. Defaults to a timestamp format %Y%m%d%H%M%S (i.e. '20141119223359').
-        This parameter is optional during I(state=present), but needs to be set explicitly for I(state=finalize).
-        You can use the generated fact I(release={{ deploy_helper.new_release }}).
+      - The release version that is being deployed. Defaults to a timestamp format C(%Y%m%d%H%M%S) (for example V(20141119223359)).
+        This parameter is optional during O(state=present), but needs to be set explicitly for O(state=finalize).
+        You can use the generated fact C(release={{ deploy_helper.new_release }}).
 
   releases_path:
     type: str
     description:
-      - The name of the folder that will hold the releases. This can be relative to I(path) or absolute.
+      - The name of the folder that will hold the releases. This can be relative to O(path) or absolute.
         Returned in the C(deploy_helper.releases_path) fact.
     default: releases
 
   shared_path:
     type: path
     description:
-      - The name of the folder that will hold the shared resources. This can be relative to I(path) or absolute.
+      - The name of the folder that will hold the shared resources. This can be relative to O(path) or absolute.
         If this is set to an empty string, no shared folder will be created.
         Returned in the C(deploy_helper.shared_path) fact.
     default: shared
@@ -84,38 +85,38 @@ options:
   current_path:
     type: path
     description:
-      - The name of the symlink that is created when the deploy is finalized. Used in I(finalize) and I(clean).
+      - The name of the symlink that is created when the deploy is finalized. Used in O(state=finalize) and O(state=clean).
         Returned in the C(deploy_helper.current_path) fact.
     default: current
 
   unfinished_filename:
     type: str
     description:
-      - The name of the file that indicates a deploy has not finished. All folders in the I(releases_path) that
-        contain this file will be deleted on I(state=finalize) with I(clean=True), or I(state=clean). This file is
-        automatically deleted from the I(new_release_path) during I(state=finalize).
+      - The name of the file that indicates a deploy has not finished. All folders in the O(releases_path) that
+        contain this file will be deleted on O(state=finalize) with O(clean=true), or O(state=clean). This file is
+        automatically deleted from the C(new_release_path) during O(state=finalize).
     default: DEPLOY_UNFINISHED
 
   clean:
     description:
-      - Whether to run the clean procedure in case of I(state=finalize).
+      - Whether to run the clean procedure in case of O(state=finalize).
     type: bool
     default: true
 
   keep_releases:
     type: int
     description:
-      - The number of old releases to keep when cleaning. Used in I(finalize) and I(clean). Any unfinished builds
+      - The number of old releases to keep when cleaning. Used in O(state=finalize) and O(state=clean). Any unfinished builds
         will be deleted first, so only correct releases will count. The current version will not count.
     default: 5
 
 notes:
-  - Facts are only returned for I(state=query) and I(state=present). If you use both, you should pass any overridden
+  - Facts are only returned for O(state=query) and O(state=present). If you use both, you should pass any overridden
     parameters to both calls, otherwise the second call will overwrite the facts of the first one.
-  - When using I(state=clean), the releases are ordered by I(creation date). You should be able to switch to a
+  - When using O(state=clean), the releases are ordered by I(creation date). You should be able to switch to a
     new naming strategy without problems.
-  - Because of the default behaviour of generating the I(new_release) fact, this module will not be idempotent
-    unless you pass your own release name with I(release). Due to the nature of deploying software, this should not
+  - Because of the default behaviour of generating the C(new_release) fact, this module will not be idempotent
+    unless you pass your own release name with O(release). Due to the nature of deploying software, this should not
     be much of a problem.
 extends_documentation_fragment:
   - ansible.builtin.files