Merge branch 'JonstonChan-improve-docs' into 'master'

Improve documentation test

See merge request gitlab-org/gitlab!69577

doc/.vale/gitlab/InternalLinkExtension.yml

@@ -10,4 +10,4 @@ link: https://docs.gitlab.com/ee/development/documentation/styleguide/index.html
 level: error
 scope: raw
 raw:
-  - '\[.+\]\((https?:){0}[\w\/\.-]+(\.html).*?\)'
+  - '\[.+\]\([\w\/\.-]+\.html[^)]*\)'

doc/.vale/gitlab/InternalLinkFormat.yml

@@ -10,4 +10,4 @@ link: https://docs.gitlab.com/ee/development/documentation/styleguide/index.html
 level: error
 scope: raw
 raw:
-  - '\[.+\]\(\.\/.+?\)'
+  - '\[.+\]\(\.\/.*?\)'

doc/.vale/gitlab/VersionText.yml

@@ -9,9 +9,9 @@
 # - `> 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.
+# Because it excludes the prefix `> - `, 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
@@ -20,4 +20,4 @@ link: https://docs.gitlab.com/ee/development/documentation/styleguide/index.html
 level: error
 scope: raw
 raw:
-  - '> (- ){0}\[?Introduced.+\n[^\n`]'
+  - '> \[?Introduced.+\n[^\n]'

doc/development/code_intelligence/index.md

@@ -37,7 +37,7 @@ sequenceDiagram
 
 1. The CI/CD job generates a document in an LSIF format (usually `dump.lsif`) using [an
    indexer](https://lsif.dev) for the language of a project. The format
-   [describes](https://github.com/sourcegraph/sourcegraph/blob/master/doc/user/code_intelligence/writing_an_indexer.md)
+   [describes](https://github.com/sourcegraph/sourcegraph/blob/main/doc/code_intelligence/explanations/writing_an_indexer.md)
    interactions between a method or function and its definition(s) or references. The
    document is marked to be stored as an LSIF report artifact.
 

doc/user/project/merge_requests/code_quality.md

@@ -275,7 +275,7 @@ might look like this example:
 job1:
   rules:
     - if: '$CI_PIPELINE_SOURCE == "merge_request_event"' # Run job1 in merge request pipelines
-    - if: '$CI_COMMIT_BRANCH == "master"'                # Run job1 in pipelines on the master branch (but not in other branch pipelines)
+    - if: '$CI_COMMIT_BRANCH == "main"'                  # Run job1 in pipelines on the main branch (but not in other branch pipelines)
     - if: '$CI_COMMIT_TAG'                               # Run job1 in pipelines for tags
 ```
 
@@ -291,7 +291,7 @@ code_quality:
     - if: '$CODE_QUALITY_DISABLED'
       when: never
     - if: '$CI_PIPELINE_SOURCE == "merge_request_event"' # Run code quality job in merge request pipelines
-    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'      # Run code quality job in pipelines on the master branch (but not in other branch pipelines)
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'      # Run code quality job in pipelines on the default branch (but not in other branch pipelines)
     - if: '$CI_COMMIT_TAG'                               # Run code quality job in pipelines for tags
 ```