Address code review feedback

- Make fix-links.sh portable with relative paths
- Add comment about reference-style link support
- Clarify no dependencies needed in GitHub Actions workflow

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

.github/workflows/validate-docs-links.yml

@@ -31,6 +31,9 @@ jobs:
         with:
           node-version: '20.x'
 
+      # Note: The validation script uses only Node.js built-in modules
+      # (fs, path, url) and requires no external dependencies
+
       - name: Validate documentation links
         id: validate
         run: |

scripts/fix-links.sh

@@ -3,9 +3,11 @@
 
 set -e
 
-DOCS_DIR="/home/runner/work/objectui/objectui/docs"
+# Get the directory where the script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DOCS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)/docs"
 
-echo "Fixing broken documentation links..."
+echo "Fixing broken documentation links in: $DOCS_DIR"
 
 # Fix /docs/ prefix (fumadocs baseUrl is already /docs, so links should not include it)
 find "$DOCS_DIR" -type f \( -name "*.md" -o -name "*.mdx" \) -exec sed -i 's|](/docs/plugins/|](/plugins/|g' {} +

scripts/validate-docs-links.mjs

@@ -63,18 +63,22 @@ function scanDirectory(dir, baseRoute = '') {
 function extractLinks(content, filePath) {
   const links = [];
 
-  // Match markdown links: [text](url)
-  const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+  // Match markdown inline links: [text](url)
+  const inlineLinkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
   let match;
 
-  while ((match = linkRegex.exec(content)) !== null) {
+  while ((match = inlineLinkRegex.exec(content)) !== null) {
     const text = match[1];
     const url = match[2];
     const line = content.substring(0, match.index).split('\n').length;
 
     links.push({ text, url, line, filePath });
   }
 
+  // Note: Reference-style links ([text][ref]) are not commonly used in this codebase
+  // and are typically resolved at build time by the documentation framework.
+  // If needed in the future, add support here.
+  
   return links;
 }