update

Author: Telucero

.github/workflows/check-url-changes.yml

@@ -1,71 +1,82 @@
-name: Navigation File Change Checker
+name: Documentation & Navigation Change Checker
 
 on:
   pull_request_target:
     branches:
       - url-test   # target branch
     paths:
+      - '**/*.md'
       - '**/*.nav.yml'
       - '**/*.nav.yaml'
 
 jobs:
-  check-nav-changes:
+  check-doc-nav-changes:
     runs-on: ubuntu-latest
     steps:
-      # 1️⃣ Checkout the PR branch (fork-safe)
+      # 1️⃣ Checkout PR branch (fork-safe)
       - name: Checkout PR branch
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
           ref: ${{ github.event.pull_request.head.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name }}
 
-      # 2️⃣ Fetch the base branch so git diff works
+      # 2️⃣ Fetch the base branch for diffs
       - name: Fetch base branch
         run: |
           git fetch origin ${{ github.event.pull_request.base.ref }} --depth=1
 
-      # 3️⃣ Detect nav file changes
-      - name: Detect nav file changes
+      # 3️⃣ Detect deleted, renamed, and modified files
+      - name: Identify documentation and nav changes
         run: |
           BASE_BRANCH=origin/${{ github.event.pull_request.base.ref }}
           HEAD_SHA=${{ github.event.pull_request.head.sha }}
 
-          # Deleted nav files
-          DELETED_NAV=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep '^D.*\.nav\.ya?ml$' | cut -f2- || true)
+          # Deleted Markdown files
+          DELETED_MD=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep '^D.*\.md$' | cut -f2- || true)
+
+          # Renamed Markdown files
+          RENAMED_MD=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep '^R.*\.md$' | awk '{print $2 " -> " $3}' || true)
 
-          # Added or modified nav files
+          # Nav files
+          DELETED_NAV=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep '^D.*\.nav\.ya?ml$' | cut -f2- || true)
           MODIFIED_NAV=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep -E '^[AM].*\.nav\.ya?ml$' | cut -f2- || true)
+          RENAMED_NAV=$(git diff --name-status $BASE_BRANCH $HEAD_SHA | grep '^R.*\.nav\.ya?ml$' | awk '{print $2 " -> " $3}' || true)
 
+          # Build NAV_CHANGES with diffs
           NAV_CHANGES=""
-
-          # Process deleted files
           for FILE in $DELETED_NAV; do
             NAV_CHANGES+="$FILE: [FILE DELETED]\n\n"
           done
-
-          # Process added or modified files
           for FILE in $MODIFIED_NAV; do
             DIFF=$(git diff $BASE_BRANCH $HEAD_SHA -- "$FILE" | grep -vE '^\+\+\+|^---' || true)
             NAV_CHANGES+="$FILE:\n$DIFF\n\n"
           done
+          for FILE in $RENAMED_NAV; do
+            NAV_CHANGES+="$FILE [RENAMED]\n\n"
+          done
 
           # Export to environment
+          echo "DELETED_MD<<EOF" >> $GITHUB_ENV
+          echo "$DELETED_MD" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+          echo "RENAMED_MD<<EOF" >> $GITHUB_ENV
+          echo "$RENAMED_MD" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
           echo "NAV_CHANGES<<EOF" >> $GITHUB_ENV
           echo -e "$NAV_CHANGES" >> $GITHUB_ENV
           echo "EOF" >> $GITHUB_ENV
 
           # Set warning flag
-          if [ -n "$NAV_CHANGES" ]; then
+          if [ -n "$DELETED_MD" ] || [ -n "$RENAMED_MD" ] || [ -n "$NAV_CHANGES" ]; then
             echo "warning=true" >> $GITHUB_ENV
           else
             echo "warning=false" >> $GITHUB_ENV
           fi
 
-          # Debug output
-          echo -e "NAV file changes detected:\n$NAV_CHANGES"
-
-      # 4️⃣ Post a comment if changes exist
+      # 4️⃣ Post PR comment if changes exist
       - name: Post PR comment
         if: env.warning == 'true'
         uses: actions/github-script@v7
@@ -74,14 +85,23 @@ jobs:
           script: |
             const issue_number = context.payload.pull_request.number;
             const repo = context.repo;
+            const deletedMd = `${process.env.DELETED_MD}`.trim();
+            const renamedMd = `${process.env.RENAMED_MD}`.trim();
             const navChanges = `${process.env.NAV_CHANGES}`.trim();
 
-            let formatted = navChanges.split('\n').map(line => {
-              if (line.includes('[FILE DELETED]')) return `❌ ${line.replace(': [FILE DELETED]', '')}`;
-              return line;
-            }).join('\n');
+            let message = `🔍 **Documentation & Navigation Checker**\n\nThis PR modifies documentation (.md) or navigation files (.nav.yml/.nav.yaml), which could affect links and Table of Contents.\n\n`;
+
+            if (deletedMd) {
+              message += `**Deleted Markdown files:**\n\`\`\`\n${deletedMd}\n\`\`\`\n\n`;
+            }
+            if (renamedMd) {
+              message += `**Renamed Markdown files:**\n\`\`\`\n${renamedMd}\n\`\`\`\n\n`;
+            }
+            if (navChanges) {
+              message += `**Navigation file changes:**\n\`\`\`\n${navChanges}\n\`\`\`\n\n`;
+            }
 
-            const message = `🔍 **Navigation File Changes Detected**\n\nThis PR modifies navigation files (.nav.yml/.nav.yaml) which could affect the Table of Contents.\n\n**Changes:**\n\`\`\`\n${formatted}\n\`\`\`\n\n🚨 Please verify:\n- Navigation structure still matches intended URLs\n- Internal links are correct\n- Any deleted entries are handled or redirected`;
+            message += `🚨 Please verify:\n- Internal links are correct\n- Navigation structure is still valid\n- Any deleted or renamed entries are handled properly`;
 
             github.rest.issues.createComment({
               owner: repo.owner,