fix(build): lint only changed markdown files in PRs

- add changed-files detection step to markdown-lint workflow

- add changed-files detection step to markdown-link-check workflow

- skip lint/link-check when no markdown files changed

📦 - Generated by Copilot

Author: WilliamBerryiii

.github/workflows/markdown-link-check.yml

@@ -28,6 +28,24 @@ jobs:
         uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v4.2.2
         with:
           persist-credentials: false
+          fetch-depth: 0
+
+      - name: Get changed markdown files
+        id: changed-files
+        shell: bash
+        run: |
+          if [ "${{ github.event_name }}" == "pull_request" ]; then
+            CHANGED_FILES=$(git diff --name-only --diff-filter=ACMRT ${{ github.event.pull_request.base.sha }} ${{ github.sha }} -- '*.md' | tr '\n' ' ')
+          else
+            CHANGED_FILES=$(git diff --name-only --diff-filter=ACMRT HEAD~1 HEAD -- '*.md' | tr '\n' ' ')
+          fi
+          echo "files=$CHANGED_FILES" >> $GITHUB_OUTPUT
+          if [ -z "$CHANGED_FILES" ]; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "Changed markdown files: $CHANGED_FILES"
+          fi
 
       - name: Setup Node.js
         uses: actions/setup-node@b9b25d45f70a5d94d88496aa4896bf9ed8f49b67 # v4.1.0
@@ -36,30 +54,38 @@ jobs:
           cache: 'npm'
 
       - name: Install dependencies
+        if: steps.changed-files.outputs.has_changes == 'true'
         run: npm ci
 
       - name: Create logs directory
+        if: steps.changed-files.outputs.has_changes == 'true'
         shell: pwsh
         run: |
           New-Item -ItemType Directory -Force -Path logs | Out-Null
 
       - name: Run markdown link check
         id: link-check
+        if: steps.changed-files.outputs.has_changes == 'true'
         shell: pwsh
         run: |
-          & scripts/linting/Markdown-Link-Check.ps1
+          $changedFiles = "${{ steps.changed-files.outputs.files }}" -split '\s+' | Where-Object { $_ }
+          & scripts/linting/Markdown-Link-Check.ps1 -Path $changedFiles
         continue-on-error: ${{ inputs.soft-fail }}
 
+      - name: Skip notification
+        if: steps.changed-files.outputs.has_changes != 'true'
+        run: echo "No markdown files changed, skipping link check."
+
       - name: Upload markdown link check results
-        if: always()
+        if: steps.changed-files.outputs.has_changes == 'true'
         uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v4.4.3
         with:
           name: markdown-link-check-results
           path: logs/markdown-link-check-results.json
           retention-days: 30
 
       - name: Check results and fail if needed
-        if: ${{ !inputs.soft-fail && steps.link-check.outcome == 'failure' }}
+        if: steps.changed-files.outputs.has_changes == 'true' && !inputs.soft-fail && steps.link-check.outcome == 'failure'
         shell: pwsh
         run: |
           Write-Host "Markdown link check failed and soft-fail is false. Failing the job."

.github/workflows/markdown-lint.yml

@@ -28,6 +28,23 @@ jobs:
         uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v4.2.2
         with:
           persist-credentials: false
+          fetch-depth: 0
+
+      - name: Get changed markdown files
+        id: changed-files
+        run: |
+          if [ "${{ github.event_name }}" == "pull_request" ]; then
+            CHANGED_FILES=$(git diff --name-only --diff-filter=ACMRT ${{ github.event.pull_request.base.sha }} ${{ github.sha }} -- '*.md' | xargs)
+          else
+            CHANGED_FILES=$(git diff --name-only --diff-filter=ACMRT HEAD~1 HEAD -- '*.md' | xargs)
+          fi
+          echo "files=$CHANGED_FILES" >> $GITHUB_OUTPUT
+          if [ -z "$CHANGED_FILES" ]; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "Changed markdown files: $CHANGED_FILES"
+          fi
 
       - name: Setup Node.js
         uses: actions/setup-node@b9b25d45f70a5d94d88496aa4896bf9ed8f49b67 # v4.1.0
@@ -36,22 +53,28 @@ jobs:
           cache: 'npm'
 
       - name: Install dependencies
+        if: steps.changed-files.outputs.has_changes == 'true'
         run: npm ci
 
       - name: Run markdown lint
         id: markdown-lint
+        if: steps.changed-files.outputs.has_changes == 'true'
         run: |
-          npm run lint:md > markdown-lint-output.txt 2>&1 || echo "MARKDOWN_LINT_FAILED=true" >> $GITHUB_ENV
+          npm run lint:md -- ${{ steps.changed-files.outputs.files }} > markdown-lint-output.txt 2>&1 || echo "MARKDOWN_LINT_FAILED=true" >> $GITHUB_ENV
           cat markdown-lint-output.txt
         continue-on-error: true
 
+      - name: Skip notification
+        if: steps.changed-files.outputs.has_changes != 'true'
+        run: echo "No markdown files changed, skipping lint."
+
       - name: Create annotations
         if: env.MARKDOWN_LINT_FAILED == 'true'
         run: |
           echo "::warning::Markdown lint found violations. Review markdown-lint-output.txt artifact for details."
 
       - name: Upload markdown lint results
-        if: always()
+        if: steps.changed-files.outputs.has_changes == 'true'
         uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v4.4.3
         with:
           name: markdown-lint-results
@@ -62,7 +85,11 @@ jobs:
         if: always()
         run: |
           echo "## Markdown Lint Results" >> $GITHUB_STEP_SUMMARY
-          if [ "${{ env.MARKDOWN_LINT_FAILED }}" == "true" ]; then
+          if [ "${{ steps.changed-files.outputs.has_changes }}" != "true" ]; then
+            echo "⏭️ **Status**: Skipped" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "No markdown files changed in this PR." >> $GITHUB_STEP_SUMMARY
+          elif [ "${{ env.MARKDOWN_LINT_FAILED }}" == "true" ]; then
             echo "❌ **Status**: Failed" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
             echo "Markdown linting violations detected. Please review the artifact for details." >> $GITHUB_STEP_SUMMARY