Docs: try auto-generation of docblock files

Author: kraftbj

.github/workflows/phpcs.yml

@@ -14,7 +14,7 @@ jobs:
     - name: Setup PHP
       uses: shivammathur/setup-php@v2
       with:
-        php-version: '8.1'
+        php-version: '8.4'
         tools: composer:v2
 
     - name: Install Dependencies

.markdownlint.json

@@ -0,0 +1,38 @@
+{
+    "default": true,
+    "MD013": false,
+    "MD024": false,
+    "MD033": {
+        "allowed_elements": [
+            "br",
+            "img",
+            "video",
+            "details",
+            "summary"
+        ]
+    },
+    "no-inline-html": {
+        "allowed_elements": [
+            "br",
+            "kbd",
+            "sup"
+        ]
+    },
+    "first-line-h1": false,
+    "commands-show-output": false,
+    "code-block-style": false,
+    "no-duplicate-heading": {
+        "siblings_only": true
+    },
+    "no-trailing-punctuation": {
+        "punctuation": ".,;:!"
+    },
+    "ol-prefix": {
+        "style": "ordered"
+    },
+    "fenced-code-language": true,
+    "ignores": [
+        "vendor/**",
+        "node_modules/**"
+    ]
+} 

composer.json

@@ -16,14 +16,22 @@
     "require-dev": {
         "wp-coding-standards/wpcs": "^3.0",
         "phpcompatibility/phpcompatibility-wp": "^2.1",
-        "sirbrillig/phpcs-changed": "^2.11"
+        "sirbrillig/phpcs-changed": "^2.11",
+        "nikic/php-parser": "^4.0",
+        "symfony/finder": "^5.0|^6.0"
     },
     "scripts": {
-        "docs-manifest": "php docs/bin/generate-manifest.php",
-        "docs-links": "php docs/bin/update-markdown-links.php",
+        "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 --output=${DOCS_OUTPUT_DIR:-docs/code-reference}",
+        "docs:fix": "npm run fix:md",
+        "docs:lint": "npm run lint:md",
         "docs": [
-            "@docs-links",
-            "@docs-manifest"
+            "@docs:parse",
+            "@docs:links",
+            "@docs:fix",
+            "@docs:lint",
+            "@docs:manifest"
         ]
     }
 }