Merge branch 'update-vale-rules' into 'master'

Update vale rules

See merge request gitlab-org/omnibus-gitlab!4673

doc/.vale/gitlab/Acronyms.yml

@@ -44,6 +44,7 @@ exceptions:
   - IBM
   - IDE
   - IID
+  - IMAP
   - IRC
   - ISO
   - JSON
@@ -65,6 +66,7 @@ exceptions:
   - POST
   - PUT
   - RAM
+  - REST
   - RPC
   - RSA
   - RSS

doc/.vale/gitlab/Admin.yml

+---
+# Warning: gitlab.Admin
+#
+# You should not use "admin", but "Admin Area" is OK.
+#
+# For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
+extends: substitution
+message: 'Use "administration", "administrator", "administer", or "Admin Area" instead of "admin" or "admin area".'
+link: https://docs.gitlab.com/ee/development/documentation/styleguide.html
+level: warning
+ignorecase: true
+swap:
+  'admin ?\w*': '(?:Admin Area|[Aa]dminist(ration|rator|er|rative))'

doc/.vale/gitlab/OutdatedVersions.yml

@@ -7,7 +7,7 @@
 extends: existence
 message: 'Can this reference to "%s" be refactored?'
 link: https://docs.gitlab.com/ee/development/documentation/styleguide.html#importance-of-referencing-gitlab-versions-and-tiers
-level: warning
+level: suggestion
 nonword: true
 ignorecase: true
 tokens:

doc/.vale/gitlab/SubstitutionWarning.yml

@@ -11,7 +11,6 @@ link: https://about.gitlab.com/handbook/communication/#top-misused-terms
 level: warning
 ignorecase: true
 swap:
-  admin: administrator
   code base: codebase
   config: configuration
   distro: distribution

doc/.vale/gitlab/Substitutions.yml

@@ -13,6 +13,7 @@ ignorecase: true
 swap:
   frontmatter: front matter
   GitLabber: GitLab team member
+  GitLab-shell: GitLab Shell
   gitlab omnibus: Omnibus GitLab
   param: parameter
   params: parameters

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

@@ -61,6 +61,7 @@ buildpacks
 bundler
 bundlers
 burndown
+burnup
 cacheable
 CAS
 CentOS
@@ -142,8 +143,10 @@ Facebook
 failover
 failovers
 failsafe
+Falco
 fastlane
 favicon
+Figma
 Filebeat
 Fio
 firewalled
@@ -166,6 +169,7 @@ Gitleaks
 Gitter
 globals
 Gmail
+Gollum
 Google
 Gosec
 Gradle
@@ -220,6 +224,7 @@ Kibana
 Kinesis
 Knative
 Kramdown
+Kubecost
 kubectl
 Kubernetes
 Kubesec
@@ -253,6 +258,7 @@ memoize
 memoized
 memoizing
 Memorystore
+mergeability
 mergeable
 Microsoft
 middleware
@@ -275,6 +281,7 @@ mockups
 ModSecurity
 monorepo
 monorepos
+multiline
 mutex
 nameserver
 nameservers
@@ -306,6 +313,7 @@ passwordless
 Patroni
 performant
 PgBouncer
+Phabricator
 phaser
 phasers
 Pipfile
@@ -346,6 +354,7 @@ Python
 Qualys
 Rackspace
 Raspbian
+Rdoc
 reachability
 rebase
 rebased
@@ -366,6 +375,8 @@ reindex
 reindexed
 reindexes
 reindexing
+reinitialize
+reinitializing
 relicensing
 remediations
 repmgr
@@ -425,7 +436,10 @@ smartcard
 smartcards
 SMTP
 Sobelow
+Solarized
 Sourcegraph
+sparkline
+sparklines
 spidering
 Splunk
 SpotBugs
@@ -441,6 +455,8 @@ subfolder
 subfolders
 subgraph
 subgraphs
+subkey
+subkeys
 sublicense
 sublicensed
 sublicenses
@@ -457,8 +473,10 @@ substring
 substrings
 subtree
 subtrees
+sudo
 syslog
 tcpdump
+Thanos
 Tiller
 timecop
 todos
@@ -481,6 +499,7 @@ unarchived
 unarchives
 unarchiving
 unassign
+unassigning
 unassigns
 uncheck
 unchecked
@@ -512,6 +531,9 @@ unprioritized
 unprotect
 unprotected
 unprotects
+unprovision
+unprovisioned
+unprovisions
 unpublish
 unpublished
 unpublishes

doc/development/openshift/README.md

@@ -66,7 +66,7 @@ If you have Docker installed, you can setup OpenShift Origin on your local machi
 1. Create a new namespace to assign storage and permissions to.
    - `oc new-project <namespace>`
-1. Login as system admin
+1. Log in as system administrator:
    - `oc login -u system:admin`
 1. In order to allow the GitLab pod to run as root you need to edit the anyuid security context: