add documetnation build action to PRs

Author: baileympearson

.github/workflows/build_and_commit_docs.yml

@@ -0,0 +1,32 @@
+on:
+  push:
+    branches: ['main']
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+  pull-requests: write
+
+name: build-and-commit-docs
+
+jobs:
+  build-docs:
+    # prevent subsequent commits from triggering the job multiple times
+    concurrency:
+      group: ci-${{ github.ref }}
+      cancel-in-progress: true
+    name: "Build documentation."
+    uses: ./.github/workflows/build.yml
+
+  commit-docs:
+    needs: [build-docs]
+    permissions:
+        contents: write
+        pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+        - name: Open Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+        title: 'docs: generate docs from latest main [skip-ci]'
+        delete-branch: true