fix: Change doc publish workflow to be like c2pa-js

.github/workflows/release.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+  workflow_dispatch:
 
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
@@ -186,3 +187,51 @@ jobs:
             -H "Content-Type: application/zip" \
             "https://uploads.github.com/repos/${{ github.repository }}/releases/${{ steps.get-release-id.outputs.id }}/assets?name=${{ steps.package-artifact.outputs.archive }}" \
             --data-binary "@generated/${{ steps.package-artifact.outputs.archive }}"
+
+  publish-docs:
+    needs: [release]
+    if: ${{ needs.release.outputs.published == 'true' }}
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          filter: tree:0
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        with:
+          run_install: false
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        env:
+          SKIP_RUST_BUILD: 1
+        run: pnpm install --frozen-lockfile
+
+      - name: Build docs
+        run: pnpm run build:docs
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/publish-docs.yml → .github/workflows/test-docs.yml

@@ -1,9 +1,6 @@
-name: Build and publish docs
+name: Test docs publishing
 
 on:
-  release:
-    types: [published]  
-
   workflow_dispatch:
 
 permissions:
@@ -12,17 +9,20 @@ permissions:
   id-token: write
 
 concurrency:
-  group: 'github-pages'
+  group: 'github-pages-test'
   cancel-in-progress: false
 
 jobs:
-  deploy:
+  publish-docs:
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v4
+        with:
+          filter: tree:0
+          fetch-depth: 0
 
       - uses: pnpm/action-setup@v4
         name: Install pnpm
@@ -40,25 +40,17 @@ jobs:
           SKIP_RUST_BUILD: 1
         run: pnpm install --frozen-lockfile
 
-      - name: Generate TypeDoc markdown (without modifying repo)
-        run: |
-          pnpm run build:docs
-          rm -rf docs-typedoc
+      - name: Build docs
+        run: pnpm run build:docs
 
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
-      - name: Build with Jekyll
-        uses: actions/jekyll-build-pages@v1
-        with:
-          source: ./docs
-
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          # Upload the built site for deployment
-          path: '_site'
+          path: 'docs'
 
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.gitignore

@@ -35,6 +35,7 @@ npm-debug.log
 yarn-error.log
 testem.log
 /typings
+CLAUDE.md
 
 # System Files
 .DS_Store
@@ -81,3 +82,6 @@ index.node
 npm-debug.log*
 cargo.log
 cross.log
+
+# Generated documentation
+/docs

README.md

@@ -45,6 +45,18 @@ This command will download precompiled binaries for the following systems:
 - Windows x86
 - Windows ARM
 
+## Documentation
+
+Complete API documentation is generated from TypeScript source using [TypeDoc](https://typedoc.org/) and published to GitHub Pages at [https://contentauth.github.io/c2pa-node-v2/](https://contentauth.github.io/c2pa-node-v2/).
+
+To generate documentation locally:
+
+```bash
+pnpm build:docs
+```
+
+This generates HTML documentation in the `docs/` directory. The `docs/` directory is not checked into version control. It's automatically generated and published to GitHub Pages whenever a new release is published.
+
 ## Components
 
 ### Reader