Merge branch 'sarahgerman-docs-site-hugo-tests' into 'master'

Add docs Hugo build test

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/180806



Merged-by: Achilleas Pipinellis <axil@gitlab.com>
Approved-by: Marcel Amirault <mamirault@gitlab.com>
Approved-by: Peter Leitzen <pleitzen@gitlab.com>
Approved-by: Achilleas Pipinellis <axil@gitlab.com>
Reviewed-by: Peter Leitzen <pleitzen@gitlab.com>
Co-authored-by: Marcel Amirault <mamirault@gitlab.com>
Co-authored-by: Sarah German <sgerman@gitlab.com>

.gitlab/ci/docs.gitlab-ci.yml

@@ -76,7 +76,7 @@ review-docs-hugo-cleanup:
 
 .docs-markdown-lint-image:
   # When updating the image version here, update it in /scripts/lint-doc.sh too.
-  image: ${REGISTRY_HOST}/${REGISTRY_GROUP}/gitlab-docs/lint-markdown:alpine-3.20-vale-3.9.3-markdownlint2-0.17.1-lychee-0.18.0
+  image: ${REGISTRY_HOST}/${REGISTRY_GROUP}/technical-writing/docs-gitlab-com/lint-markdown:alpine-3.21-vale-3.9.3-markdownlint2-0.17.1-lychee-0.18.0
 
 docs-lint markdown:
   extends:
@@ -111,6 +111,28 @@ docs code_quality:
     expire_in: 2 weeks
     when: always
 
+docs hugo_build:
+  image: hugomods/hugo:exts-0.142.0
+  extends:
+    - .default-retry
+    - .docs:rules:docs-lint
+  stage: lint
+  needs: []
+  dependencies: []
+  before_script:
+    - apk add --no-cache git make nodejs npm bash
+    - git clone --depth 1 --filter=tree:0 https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com.git
+    - cd docs-gitlab-com
+    - make add-latest-icons
+    # Copy the current project's docs to the appropriate location in the docs website
+    - cp -r ../doc/* content/
+  script:
+    # Test that Hugo will build
+    - hugo --gc --printPathWarnings --panicOnWarning
+    # Test for invalid index pages
+    # See https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/blob/main/scripts/check-index-filenames.sh
+    - make check-index-pages SEARCH_DIR="../doc"
+
 docs-lint links:
   extends:
     - .docs:rules:docs-lint

doc/development/documentation/backporting.md

@@ -87,7 +87,7 @@ For the change to appear in:
 - `docs.gitlab.com`, the release manager only has to merge the MR to the stable branch,
   and the technical writer needs to [deploy the backport changes](#deploy-the-backport-changes).
 - `gitlab.com/help`, the change needs to be part of a GitLab release. The release
-  manager can include the change in the next release they create. This is an optional step.
+  manager can include the change in the next release they create. This step is optional.
 
 ### Deploy the backport changes
 

scripts/lint-doc.sh

@@ -188,7 +188,7 @@ function run_locally_or_in_container() {
   local cmd=$1
   local args=$2
   local files=$3
-  local registry_url="registry.gitlab.com/gitlab-org/gitlab-docs/lint-markdown:alpine-3.20-vale-3.9.3-markdownlint2-0.17.1-lychee-0.18.0"
+  local registry_url="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"
 
   if hash "${cmd}" 2>/dev/null
   then