Run linting/fixing before compare

Author: kraftbj

.github/workflows/verify-docs.yml

@@ -28,14 +28,15 @@ jobs:
         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": [

docs/bin/generate-parsed-md.php

@@ -158,7 +158,7 @@ public function generate() {
 	 */
 	private function process_file( $file ) {
 		$code = file_get_contents( $file->getRealPath() );
-		$ast  = $this->parser->parse( $code );
+		$ast  = $this->parser->Parse( $code );
 
 		if ( ! $ast ) {
 			return;