Update linting tools in project

Author: eread

.gitlab/ci/_common.gitlab-ci.yml

@@ -7,6 +7,7 @@ variables:
   RUNNER_IMAGES_VERSION: "0.0.14"
   RUNNER_IMAGES_WINDOWS_GO_URL: https://gitlab.com/api/v4/projects/gitlab-org%2fci-cd%2frunner-tools%2fbase-images/packages/generic/runner-images/v${RUNNER_IMAGES_VERSION}/golang-windows-amd64.zip
   CI_IMAGE: "${RUNNER_IMAGES_REGISTRY}/ci:${RUNNER_IMAGES_VERSION}"
+  DOCS_LINT_IMAGE: registry.gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/lint-markdown:alpine-3.21-vale-3.11.2-markdownlint2-0.17.2-lychee-0.18.1
   # Feature flags
   FF_SCRIPT_SECTIONS: "true"
   FF_USE_FASTZIP: "true"

.gitlab/ci/qa.gitlab-ci.yml

@@ -92,13 +92,15 @@ mage tests:
 
 # Perform documentation linting and link checking on Markdown files
 docs:lint markdown:
-  image: registry.gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/lint-markdown:alpine-3.20-vale-3.9.3-markdownlint2-0.17.1-lychee-0.15.1
+  image: $DOCS_LINT_IMAGE
   stage: qa
   extends:
     - .rules:merge_request_pipelines
     - .no_cache_and_dependencies
   needs: []
   script:
+    # Makefiles in this project expect Go to be available
+    - apk add --quiet go
     # Lint content and Markdown, and check links
     - make lint-docs VALE_MIN_ALERT_LEVEL=error
 

.tool-versions

@@ -4,5 +4,6 @@ yq 4.44.3
 mockery 2.43.0
 
 # For linting documentation
-markdownlint-cli2 0.17.1
-vale 3.9.3
+markdownlint-cli2 0.17.2
+lychee 0.18.1
+vale 3.11.2

.vale.ini

@@ -1,10 +1,12 @@
 # Vale configuration file.
 #
-# For more information, see https://errata-ai.gitbook.io/vale/getting-started/configuration.
+# For more information, see https://vale.sh/docs/vale-ini.
 
 StylesPath = docs/.vale
 MinAlertLevel = suggestion
 
+IgnoredScopes = code, text.frontmatter.redirect_to
+
 [*.md]
 BasedOnStyles = gitlab_base, gitlab_docs