Run linting/fixing before compare

Author: kraftbj

.github/workflows/verify-docs.yml

@@ -22,20 +22,25 @@ jobs:
           coverage: none
 
       - name: Install dependencies
-        run: composer install --prefer-dist --no-progress
+        run: |
+          # Install PHP dependencies
+          composer install --prefer-dist --no-progress
+          # Install Node.js dependencies
+          npm ci
 
       - name: Generate fresh documentation
         run: |
           # Create temp directory for fresh docs
           mkdir -p temp/code-reference
-          # Generate fresh documentation
-          php docs/bin/generate-parsed-md.php --output=temp/code-reference
+          
+          # Run full docs workflow with new output directory
+          DOCS_OUTPUT_DIR=temp/code-reference composer run docs
 
       - name: Compare documentation
         run: |
           # Compare generated docs with existing docs
-          if ! diff -r --ignore-all-space --ignore-blank-lines docs/code-reference temp/code-reference; then
+          if ! diff -r --ignore-all-space --ignore-blank-lines --ignore-matching-lines='^<https.*>$' docs/code-reference temp/code-reference; then
             echo "::error::Documentation in docs/code-reference does not match what would be generated from source code."
-            echo "::error::Please update the source code documentation instead of modifying the generated files directly."
+            echo "::error::The markdown files are generated from PHP docblocks - please update the source code documentation instead."
             exit 1
           fi 

composer.json

@@ -23,7 +23,7 @@
     "scripts": {
         "docs:manifest": "php docs/bin/generate-manifest.php",
         "docs:links": "php docs/bin/update-markdown-links.php",
-        "docs:parse": "php docs/bin/generate-parsed-md.php",
+        "docs:parse": "php docs/bin/generate-parsed-md.php --output=${DOCS_OUTPUT_DIR:-docs/code-reference}",
         "docs:fix": "npm run fix:md",
         "docs:lint": "npm run lint:md",
         "docs": [