From 063c626af659a2bbfb991927fcc1f123dce0b46b Mon Sep 17 00:00:00 2001
From: Radhika Gupta <guptaradhika@microsoft.com>
Date: Wed, 13 May 2026 14:50:29 -0700
Subject: [PATCH] Only redeploy docs when package version changes

Add a version check job that compares the version field in package.json
between the current and previous commit. Docs are only rebuilt and
deployed when the version actually changes, not on every PR merge.
Manual workflow_dispatch still triggers a full deploy.
---
 .github/workflows/docs.yml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index c296dbf..03c52c0 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -3,6 +3,8 @@ name: Deploy TypeDoc
 on:
   push:
     branches: [main]
+    paths:
+      - 'package.json'
   workflow_dispatch:
 
 permissions:
@@ -15,8 +17,34 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
+  check-version:
+    name: Check version change
+    runs-on: ubuntu-latest
+    outputs:
+      changed: ${{ github.event_name == 'workflow_dispatch' || steps.version.outputs.changed == 'true' }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Check if version changed
+        id: version
+        run: |
+          CURRENT=$(node -p "require('./package.json').version")
+          if ! git show HEAD~1:package.json > prev-package.json 2>/dev/null; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          PREVIOUS=$(node -p "require('./prev-package.json').version")
+          if [ "$CURRENT" != "$PREVIOUS" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
   build:
     name: Generate docs
+    needs: check-version
+    if: needs.check-version.outputs.changed == 'true'
     runs-on: ubuntu-latest
 
     steps: