Restore documentation linter

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/workflows/Build-Docs.yml

@@ -10,6 +10,7 @@ on:
 
 permissions:
   contents: read # to checkout the repo
+  statuses: write # to create commit status
 
 jobs:
   Build-Docs:
@@ -78,31 +79,38 @@ jobs:
             }
 
       - name: Lint documentation
-        id: markdownlint
-        uses: DavidAnson/markdownlint-cli2-action@21c1be1b93ad9ed58fa840aacc3f279cde2a72ff # v24.2.0
-        with:
-          config: .github/linters/.markdown-lint.yml
-          globs: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs/**/*.md
+        id: super-linter
+        uses: super-linter/super-linter/slim@4ce20838b8ab83717e78138c5b3a1407148e0918 # v8.7.0
+        env:
+          RUN_LOCAL: true
+          DEFAULT_BRANCH: main
+          DEFAULT_WORKSPACE: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+          FILTER_REGEX_INCLUDE: ${{ fromJson(inputs.Settings).WorkingDirectory }}/outputs/docs
+          ENABLE_GITHUB_ACTIONS_GROUP_TITLE: true
+          GITHUB_TOKEN: ${{ github.token }}
+          VALIDATE_ALL_CODEBASE: true
+          VALIDATE_BIOME_FORMAT: false
+          VALIDATE_BIOME_LINT: false
+          VALIDATE_GITHUB_ACTIONS_ZIZMOR: false
+          VALIDATE_GITLEAKS: false
+          VALIDATE_JSCPD: false
+          VALIDATE_JSON_PRETTIER: false
+          VALIDATE_MARKDOWN_PRETTIER: false
+          VALIDATE_YAML_PRETTIER: false
+          ENABLE_GITHUB_ACTIONS_STEP_SUMMARY: false
+          SAVE_SUPER_LINTER_SUMMARY: true
 
-      - name: Summarize documentation lint
-        if: always()
+      - name: Post super-linter summary
+        if: failure() || fromJson(inputs.Settings).Build.Docs.ShowSummaryOnSuccess == true
         shell: pwsh
         env:
-          LINT_OUTCOME: ${{ steps.markdownlint.outcome }}
-          WORKING_DIRECTORY: ${{ fromJson(inputs.Settings).WorkingDirectory }}
+          SUPER_LINTER_OUTCOME: ${{ steps.super-linter.outcome }}
         run: |
-          $docsPath = Join-Path -Path $env:GITHUB_WORKSPACE -ChildPath "$env:WORKING_DIRECTORY/outputs/docs"
-          $fileCount = if (Test-Path -Path $docsPath) {
-              @(Get-ChildItem -Path $docsPath -Recurse -File -Include '*.md', '*.markdown').Count
-          } else {
-              0
-          }
+          $summaryPath = Join-Path $env:GITHUB_WORKSPACE 'super-linter-output' 'super-linter-summary.md'
+          Get-Content $summaryPath | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
 
-          @(
-              '## Documentation lint'
-              ''
-              '- Tool: `markdownlint-cli2-action v24.2.0`'
-              '- Configuration: `.github/linters/.markdown-lint.yml`'
-              "- Files checked: $fileCount"
-              "- Result: **$env:LINT_OUTCOME**"
-          ) | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+          $failed = $env:SUPER_LINTER_OUTCOME -eq 'failure'
+          if ($failed) {
+              Write-Host "::error::Super-linter found issues. Please review the summary above."
+              exit 1
+          }