coder
diff --git a/‎.github/actions/docs-shared/action.yaml
Lines changed: 18 additions & 9 deletions b/‎.github/actions/docs-shared/action.yaml
Lines changed: 18 additions & 9 deletions
diff --git a/‎.github/workflows/docs-link-check.yaml
Lines changed: 16 additions & 3 deletions b/‎.github/workflows/docs-link-check.yaml
Lines changed: 16 additions & 3 deletions
diff --git a/‎.github/workflows/docs-unified.yaml
Lines changed: 1 addition & 0 deletions b/‎.github/workflows/docs-unified.yaml
Lines changed: 1 addition & 0 deletions
@@ -448,8 +448,8 @@ runs:
         echo "status=success" >> $GITHUB_OUTPUT
         echo "result=" >> $GITHUB_OUTPUT
         
-        # Setup regex patterns for cross-references
-        MD_LINK_PATTERN='\[([^\]]+)\]\(([^)]+)\)'
+        # Setup regex patterns for cross-references (escape special regex characters)
+        MD_LINK_PATTERN='\[[^\]]+\]\([^)]+\)'
         ANCHOR_LINK_PATTERN='\(#[^)]+\)'
         
         # Get the base commit to compare against
@@ -474,8 +474,14 @@ runs:
           
           # Check if file exists in commit
           if git cat-file -e $commit:$file 2>/dev/null; then
-            git show $commit:$file | grep -E '^#{1,6} ' | sed 's/^#* //' | tr -d '`' | \
-            tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9 -]//g' | sed 's/ /-/g'
+            # Extract and process headings with error handling
+            git show $commit:$file 2>/dev/null | grep -E '^#{1,6} ' | 
+            while IFS= read -r line; do
+              echo "$line" | sed 's/^#* //' | tr -d '`' | 
+              tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9 -]//g' | sed 's/ /-/g' || echo ""
+            done
+          else
+            echo "File not found in commit: $file@$commit" >&2
           fi
         }
         
@@ -537,9 +543,10 @@ runs:
             for heading in $old_headings; do
               if ! echo "$new_headings" | grep -q "$heading"; then
                 # This heading was removed or changed
-                # Look for references to this heading
-                sanitized=${heading//\//\\/}  # Escape / for grep
-                refs=$(grep -r --include="*.md" -l "#$sanitized)" . || echo "")
+                # Look for references to this heading with proper escaping
+                # Use grep -F for fixed string matching instead of regex
+                sanitized="${heading}"
+                refs=$(grep -r --include="*.md" -F -l "#$sanitized)" . || echo "")
                 
                 if [ -n "$refs" ]; then
                   for ref_file in $refs; do
@@ -573,8 +580,10 @@ runs:
       id: generate-preview
       shell: bash
       run: |
-        # Simple branch name extraction and URL generation
-        BRANCH=$(git rev-parse --abbrev-ref HEAD | sed 's/[^a-zA-Z0-9_-]/-/g')
+        # Robust branch name extraction with fallbacks for CI environments
+        BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" | sed 's/[^a-zA-Z0-9_-]/-/g')
+        # Store branch for other steps
+        echo "BRANCH=$BRANCH" >> $GITHUB_ENV
         echo "url=https://coder.com/docs/@$BRANCH" >> $GITHUB_OUTPUT
         
         # Generate direct links to changed docs
 
@@ -87,8 +87,11 @@ jobs:
           if [ -f "./lychee-result.json" ]; then
             echo "Reading link check results from lychee-result.json"
             
-            # Count broken links - lychee format is different from linkspector
-            BROKEN_LINKS=$(jq '.data.failed | length' "./lychee-result.json")
+            # Count broken links with error handling
+            BROKEN_LINKS=0
+            if jq -e '.data.failed' "./lychee-result.json" > /dev/null 2>&1; then
+              BROKEN_LINKS=$(jq '.data.failed | length' "./lychee-result.json" || echo "0")
+            fi
             echo "broken_links=$BROKEN_LINKS" >> $GITHUB_OUTPUT
             
             if [ "$BROKEN_LINKS" -gt 0 ]; then
@@ -130,6 +133,15 @@ jobs:
             ISSUE_CONTENT+="2. Update the link if needed or remove it\n"
             ISSUE_CONTENT+="3. If the link is valid but fails the check, consider adding it to the ignore list in `.github/docs/.lycheeignore`\n\n"
             
+            # Use cat with heredoc instead of echo -e for more reliable newline handling
+            cat << 'EOT' >> /tmp/issue-guidance.txt
+### Additional Guidance
+- For 404 errors: Check if the resource was moved or renamed
+- For timeout errors: The site might be temporarily down, consider retrying
+- For redirect issues: Update to the final URL
+EOT
+            ISSUE_CONTENT+=$(cat /tmp/issue-guidance.txt)
+            
             ISSUE_CONTENT+="### For Broken Cross-References\n\n"
             ISSUE_CONTENT+="1. Update references to deleted or renamed files\n"
             ISSUE_CONTENT+="2. Update references to removed headings\n"
@@ -164,7 +176,8 @@ jobs:
             documentation
             bug
             needs-triage
-          assignees: EdwardAngert # Assign to docs team lead
+          # Configure assignee through CODEOWNERS or a team instead of hardcoding
+          # Additional reviewers can be added in codeowners file or docs team
 
       # Log result for troubleshooting  
       - name: Log issue creation status
 
@@ -65,6 +65,7 @@ jobs:
       # Phase 2: Prepare PR Information
       - name: Get PR info
         id: pr_info
+        if: github.event.pull_request
         run: |
           set -euo pipefail
           PR_NUMBER=${{ github.event.pull_request.number }}