Merge branch '276199-vale-acronym-rule' into 'master'

Docs - clean up some warnings detected by the Vale Acronym rule

See merge request gitlab-org/gitlab!49531

doc/.vale/gitlab/Acronyms.yml

@@ -14,6 +14,7 @@ first: '\b([A-Z]{3,5})\b'
 second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
 # ... with the exception of these:
 exceptions:
+  - AJAX
   - ANSI
   - API
   - ARM
@@ -21,11 +22,14 @@ exceptions:
   - ASCII
   - AWS
   - BSD
+  - CAS
   - CLI
   - CNA
   - CNAME
   - CORE
   - CPU
+  - CRIME
+  - CSRF
   - CSS
   - CSV
   - CVE
@@ -33,19 +37,28 @@ exceptions:
   - DAST
   - DHCP
   - DNS
+  - DOM
+  - DSA
   - DVCS
+  - ECDSA
   - EKS
   - EOL
+  - EXIF
   - FAQ
   - FOSS
+  - FQDN
   - GCP
   - GDK
+  - GDPR
   - GET
   - GIF
   - GKE
   - GNU
   - GPG
   - GPL
+  - GUI
+  - HAML
+  - HIPAA
   - HTML
   - HTTP
   - HTTPS
@@ -55,11 +68,13 @@ exceptions:
   - IDE
   - IID
   - IMAP
+  - IOPS
   - IRC
   - ISO
   - JPEG
   - JPG
   - JSON
+  - JWT
   - LAN
   - LDAP
   - LDAPS
@@ -76,17 +91,25 @@ exceptions:
   - NOTE
   - NPM
   - ONLY
+  - OWASP
+  - PAT
+  - PCI-DSS
   - PDF
+  - PEM
+  - PEP
   - PGP
   - PHP
   - PNG
   - POST
   - PUT
   - RAM
+  - RDP
   - REST
+  - RFC
   - RHEL
   - RPC
   - RPM
+  - RPS
   - RSA
   - RSS
   - RVM
@@ -101,8 +124,12 @@ exceptions:
   - SLA
   - SMS
   - SMTP
+  - SOC
+  - SOX
+  - SPF
   - SQL
   - SSD
+  - SSG
   - SSH
   - SSL
   - SSO
@@ -119,9 +146,12 @@ exceptions:
   - URL
   - USB
   - UTC
+  - UTF
   - UUID
+  - VCS
   - VPC
   - WIP
   - WSL
   - XML
+  - XSS
   - YAML

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

@@ -300,6 +300,7 @@ NGINX
 Nokogiri
 npm
 Nurtch
+nyc
 OAuth
 offboarded
 offboarding

doc/user/packages/go_proxy/index.md

@@ -159,7 +159,7 @@ later, can be written with `go env -w <var>=<value>`. For example,
 
 Go modules and module versions are defined by source repositories, such as Git,
 SVN, and Mercurial. A module is a repository that contains `go.mod` and Go
-files. Module versions are defined by VCS tags.
+files. Module versions are defined by version control system (VCS) tags.
 
 To publish a module, push `go.mod` and source files to a VCS repository. To
 publish a module version, push a VCS tag.

doc/user/project/highlighting.md

@@ -28,7 +28,7 @@ The paths here are simply Git's built-in [`.gitattributes` interface](https://gi
 /Nicefile gitlab-language=ruby
 ```
 
-To disable highlighting entirely, use `gitlab-language=text`. Lots more fun shenanigans are available through CGI options, such as:
+To disable highlighting entirely, use `gitlab-language=text`. Lots more fun shenanigans are available through common gateway interface (CGI) options, such as:
 
 ``` conf
 # json with erb in it

doc/user/project/merge_requests/test_coverage_visualization.md

@@ -60,7 +60,7 @@ the `filename` of a `class` element contains the full path relative to the proje
 ### JavaScript example
 
 The following [`gitlab-ci.yml`](../../../ci/yaml/README.md) example uses [Mocha](https://mochajs.org/)
-JavaScript testing and [NYC](https://github.com/istanbuljs/nyc) coverage-tooling to
+JavaScript testing and [nyc](https://github.com/istanbuljs/nyc) coverage-tooling to
 generate the coverage artifact:
 
 ```yaml

doc/user/project/pages/custom_domains_ssl_tls_certification/ssl_tls_concepts.md

@@ -17,7 +17,7 @@ it secured by HTTPS, you will have to issue a certificate for that
 (sub)domain and install it on your project.
 
 NOTE:
-Certificates are NOT required to add to your custom
+Certificates are **not** required to add to your custom
 (sub)domain on your GitLab Pages project, though they are
 highly recommendable.
 

doc/user/project/pages/getting_started/pages_forked_sample_project.md

@@ -7,7 +7,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 # Create a Pages website from a forked sample
 
-GitLab provides [sample projects for the most popular Static Site Generators](https://gitlab.com/pages).
+GitLab provides [sample projects for the most popular Static Site Generators (SSG)](https://gitlab.com/pages).
 You can fork one of the sample projects and run the CI/CD pipeline to generate a Pages website.
 
 Fork a sample project when you want to test GitLab Pages or start a new project that's already

doc/user/project/pages/lets_encrypt_for_gitlab_pages.md

@@ -13,7 +13,7 @@ This method is still valid but was **deprecated** in favor of the
 introduced in GitLab 12.1.
 
 If you have a GitLab Pages website served under your own domain,
-you might want to secure it with a SSL/TSL certificate.
+you might want to secure it with a SSL/TLS certificate.
 
 [Let's Encrypt](https://letsencrypt.org) is a free, automated, and
 open source Certificate Authority.

doc/user/project/repository/web_editor.md

@@ -32,7 +32,7 @@ When you are satisfied with your new file, click **Commit Changes** at the botto
 ### Shortcuts
 
 You can use handy shortcuts when editing a file through the Web Editor, which are the same as
-the WEB IDE's. For details, see the documentation for [Command Palette](../web_ide/index.md#command-palette).
+the Web IDE's. For details, see the documentation for [Command Palette](../web_ide/index.md#command-palette).
 
 ### Template dropdowns
 

doc/user/project/settings/import_export.md

@@ -119,7 +119,7 @@ The following items will be exported:
 - Pipelines history
 - Push Rules
 
-The following items will NOT be exported:
+The following items will **not** be exported:
 
 - Build traces and artifacts
 - Container registry images

doc/user/project/settings/index.md

@@ -31,11 +31,11 @@ The project description also partially supports [standard Markdown](../../markdo
 
 You can select a framework label to identify that your project has certain compliance requirements or needs additional oversight. Available labels include:
 
-- GDPR - General Data Protection Regulation
-- HIPAA - Health Insurance Portability and Accountability Act
-- PCI-DSS - Payment Card Industry-Data Security Standard
-- SOC 2 - Service Organization Control 2
-- SOX - Sarbanes-Oxley
+- GDPR (General Data Protection Regulation)
+- HIPAA (Health Insurance Portability and Accountability Act)
+- PCI-DSS (Payment Card Industry-Data Security Standard)
+- SOC 2 (Service Organization Control 2)
+- SOX (Sarbanes-Oxley)
 
 NOTE:
 Compliance framework labels do not affect your project settings.

doc/user/project/wiki/index.md

@@ -226,4 +226,4 @@ Example for `_sidebar` (using Markdown format):
 - [Sidebar](_sidebar)
 ```
 
-Support for displaying a generated TOC with a custom side navigation is planned.
+Support for displaying a generated table of contents with a custom side navigation is planned.