chore(docs): add hookdoc build workflow

Adds a GitHub Actions workflow to build and publish PHP hook
documentation to GitHub Pages, replacing the need for a dedicated
long-lived docs branch.

- Workflow triggers on push to master, release publish, and manual dispatch
- Adds jsdoc + wp-hookdoc (with patch) + patch-package
- Adds build:docs script; does not modify main build pipeline
- Ignores generated docs/ output (published to gh-pages)

Author: PatelUtkarsh

.github/workflows/build-docs.yml

@@ -0,0 +1,37 @@
+name: Build Docs
+
+on:
+  push:
+    branches:
+      - master
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  hookdocs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build docs
+        run: npm run build:docs
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs

.gitignore

@@ -61,3 +61,6 @@ package/dist
 
 # PHPStan result cache
 /.phpstan-cache/
+
+# Generated docs (published to gh-pages by workflow)
+/docs/

.hookdoc/layout.tmpl

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="utf-8">
+	<title><?js= title ?> - Cloudinary Docs</title>
+
+	<script src="scripts/prettify/prettify.js"></script>
+	<script src="scripts/prettify/lang-css.js"></script>
+	<!--[if lt IE 9]>
+	<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+	<![endif]-->
+	<link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+	<link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+
+	<link
+			href="https://fonts.googleapis.com/css?family=IBM+Plex+Mono|IBM+Plex+Sans:300,400|Playfair+Display:900&display=swap"
+			rel="stylesheet">
+</head>
+
+<body>
+
+<div id="main">
+
+	<?js if (title !== 'Home') { ?>
+	<h1 class="page-title"><?js= title ?></h1>
+	<?js } ?>
+
+	<?js= content ?>
+</div>
+
+<nav>
+	<?js= this.nav ?>
+</nav>
+
+<br class="clear">
+
+<footer>
+	<a href="https://cloudinary.com/" target="_blank" rel="noopener noreferrer">Cloudinary</a> |
+	<a href="https://github.com/cloudinary/cloudinary_wordpress/" target="_blank" rel="noopener noreferrer">Cloudinary
+		on GitHub</a>
+</footer>
+
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"></script>
+</body>
+</html>

hookdoc-conf.json

@@ -0,0 +1,19 @@
+{
+  "opts": {
+    "destination": "docs",
+    "template": "node_modules/wp-hookdoc/template",
+    "recurse": true,
+    "readme": "./README.md"
+  },
+  "source": {
+    "includePattern": ".+\\.(php|inc)?$"
+  },
+  "plugins": [
+    "node_modules/wp-hookdoc/plugin"
+  ],
+  "templates": {
+    "default": {
+      "layoutFile": ".hookdoc/layout.tmpl"
+    }
+  }
+}