Merge branch 'eread/fix-vale-rule-commenting' into 'master'

Fix vale rule comments

See merge request gitlab-org/gitlab!47152

doc/.vale/gitlab/AlertBoxCaution.yml

 ---
 # Error: gitlab.AlertBoxCaution
 #
-# Makes sure DANGER: alert boxes follow standard formatting.
+# Makes sure CAUTION: alert boxes follow standard formatting.
 #
 # For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
 extends: substitution

doc/.vale/gitlab/CurlStringsQuoted.yml

 ---
 # Warning: gitlab.CurlStringsQuoted
 #
-# Ensures all codeblocks using curl quote any URL strings.
+# Ensures all code blocks using curl quote any URL strings.
 #
 # For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
 extends: existence

doc/.vale/gitlab/VersionText.yml

 ---
 # Error: gitlab.VersionText
 #
-# Checks for use of some of the top misused terms at GitLab.
-# For substitutions only flagged as warnings, see SubstitutionWarning.yml
+# Checks that version text is formatted correctly.
+#
+# Specifically looks for either of the following that is immediately followed on the next line
+# by content, which will break rendering:
+#
+# - `> Introduced` (version text without a link)
+# - `> [Introduced` (version text with a link)
+#
+# Because it excludes `-`, it doesn't look for multi-line version text, for which content
+# immediately on the next line is ok. However, this will often highlight where multi-line version
+# text is attempted without `-` characters.
 #
 # For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
 extends: existence