Refresh Vale rules and link checking Docker image

Author: eread

doc/.vale/gitlab/CommandStringsQuoted.yml

@@ -0,0 +1,14 @@
+---
+# Error: gitlab.CommandStringsQuoted
+#
+# Ensures all code blocks wrap URL strings in quotation marks.
+#
+# For a list of all options, see https://vale.sh/docs/topics/styles/
+extends: existence
+message: "For the command example, use double quotes around the URL: %s"
+link: https://docs.gitlab.com/ee/development/documentation/restful_api_styleguide.html#curl-commands
+level: error
+scope: raw
+nonword: true
+tokens:
+  - '(curl|--url)[^"\]\n]+?https?:\/\/[^ \n]*'

doc/.vale/gitlab/CurlStringsQuoted.yml

@@ -7,12 +7,13 @@
 extends: existence
 message: "Rename the heading '%s', or re-purpose the content elsewhere."
 level: warning
-scope: heading
 link: https://docs.gitlab.com/ee/development/documentation/topic_types/concept.html#concept-headings
-ignorecase: false
+ignorecase: true
+nonword: true
+scope: raw
 tokens:
-  - How it works
-  - Limitations
-  - Overview
-  - Use cases?
-  - Important notes?
+  - '\#+ How it works'
+  - '\#+ Limitations'
+  - '\#+ Overview'
+  - '\#+ Use cases?'
+  - '\#+ Important notes?'

doc/.vale/gitlab/HeadingContent.yml

@@ -5,11 +5,12 @@
 #
 # For a list of all options, see https://vale.sh/docs/topics/styles/
 extends: existence
-message: "Improve SEO and accessibility by rewriting '%s' in the link text."
+message: "Improve SEO and accessibility by rewriting the link text for '%s'."
 level: warning
-scope: link
 ignorecase: true
 link: https://docs.gitlab.com/ee/development/documentation/styleguide/index.html#text-for-links
+scope: raw
+nonword: true
 tokens:
-  - here
-  - this page
+  - \[here\]\(.*\)
+  - \[this page\]\(.*\)

doc/.vale/gitlab/Markdown_emoji.yml

@@ -18,18 +18,27 @@ swap:
   click: "select"
   code base: "codebase"
   config: "configuration"
+  confirmation box: "confirmation dialog"
+  confirmation dialog box: "confirmation dialog"
   deselect: "clear"
   deselected: "cleared"
+  dialog box: "dialog"
   distro: "distribution"
   docs: "documentation"
   e-mail: "email"
+  emojis: "emoji"
   ex: "for example"
   file name: "filename"
   filesystem: "file system"
   info: "information"
+  installation from source: self-compiled installation
+  installations from source: self-compiled installations
   it is recommended: "you should"
   logged in user: "authenticated user"
   logged-in user: "authenticated user"
+  modal dialog: "dialog"
+  modal window: "dialog"
+  modal: "dialog"
   n/a: "not applicable"
   navigate to: "go to"
   OAuth2: "OAuth 2.0"
@@ -38,10 +47,15 @@ swap:
   once that: "after that"
   once the: "after the"
   once you: "after you"
+  pop-up window: "dialog"
+  pop-up: "dialog"
+  popup: "dialog"
   repo: "repository"
   signed in user: "authenticated user"
   signed-in user: "authenticated user"
   since: "because' or 'after"
+  source (?:install|installation): self-compiled installation
+  source (?:installs|installations): self-compiled installations
   sub-group: "subgroup"
   sub-groups: "subgroups"
   timezone: "time zone"

doc/.vale/gitlab/MeaningfulLinkWords.yml

@@ -10,6 +10,7 @@ link: https://docs.gitlab.com/ee/development/documentation/styleguide/word_list.
 level: suggestion
 ignorecase: true
 swap:
+  as well as: "Use 'and' instead of 'as well as'."
   note that: "Remove the phrase 'note that'."
   please: "Use 'please' only if we've inconvenienced the user."
   respectively: "Remove 'respectively' and list each option instead."

doc/.vale/gitlab/SubstitutionWarning.yml

@@ -995,7 +995,7 @@ tcpdump
 teardown
 templated
 Thanos
-Thoughtbot
+thoughtbot
 throughputs
 Tiller
 timebox

doc/.vale/gitlab/Wordy.yml

@@ -6,7 +6,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 # Set up your development environment
 
-Development of Omnibus GitLab can be done using an existing package available
+Development of the Linux package can be done using an existing package available
 from the [Downloads page](https://about.gitlab.com/install/). To know how to setup
 a build environment to build these packages and use them, please read
 [Setting up a Build Environment](../build/build_package.md#prepare-a-build-environment)

doc/.vale/gitlab/spelling-exceptions.txt

@@ -982,7 +982,7 @@ local mirror that are no longer present in the corresponding GitLab repository.
 
    ```shell
    pulp rpm repository create --retain-package-versions=1 --name "gitlab-ee"
-   pulp rpm remote create --name gitlab-ee --url http://mirror.example.com/repos/gitlab_gitlab-ee/ --policy immediate
+   pulp rpm remote create --name gitlab-ee --url "http://mirror.example.com/repos/gitlab_gitlab-ee/" --policy immediate
    pulp rpm repository update --name gitlab-ee --remote gitlab-ee
    ```