From 152c157b513994b726b0fc34d9f6183e3191b723 Mon Sep 17 00:00:00 2001
From: Chris Titus <contact@christitus.com>
Date: Wed, 18 Feb 2026 12:31:08 -0600
Subject: [PATCH] fix docs to create pr

---
 .github/workflows/docs.yaml | 28 ++++++++++++++++++----------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index e0c04262..55da20d3 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -15,6 +15,7 @@ permissions:
   contents: write
   pages: write
   id-token: write
+  pull-requests: write
 
 concurrency:
   group: "pages"
@@ -50,17 +51,24 @@ jobs:
         run: |
           Set-Location tools
           ./devdocs-generator.ps1
-      - name: Commit generated docs
+      
+      - name: Create Pull Request 🚀
+        id: cpr
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'Update generated documentation'
+          title: 'chore: Update Generated Dev Docs'
+          body: 'Automated update of generated documentation from JSON sources'
+          branch: docs-update
+          delete-branch: true
+          labels: automated
+      
+      - name: Check outputs
         run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add docs/content/dev/
-          if git diff --staged --quiet; then
-            echo "No changes to commit"
-          else
-            git commit -m "regenerated dev docs from workflow"
-            git push
-          fi
+          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
+          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"
+      
       - name: Install Node.js dependencies
         run: "cd docs && [[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
       - name: Cache Restore