feat(docs): add workflow to generate documentation on PR merge

.github/workflows/check.yml

@@ -26,21 +26,19 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          submodules: 'recursive'
+          submodules: "recursive"
       - uses: ./.github/actions/install-system-dependencies
       - uses: ./.github/actions/install-go
       - uses: ./.github/actions/make-deps
       - run: make gen
       - run: git diff --exit-code
-      - run: make docsgen-cli
-      - run: git diff --exit-code
   check-lint:
     name: Check (lint-all)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
-          submodules: 'recursive'
+          submodules: "recursive"
       - uses: ./.github/actions/install-system-dependencies
       - uses: ./.github/actions/install-go
       - uses: ./.github/actions/make-deps
@@ -52,7 +50,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          submodules: 'recursive'
+          submodules: "recursive"
       - uses: ./.github/actions/install-go
       - run: go fmt ./...
       - run: git diff --exit-code
@@ -62,7 +60,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          submodules: 'recursive'
+          submodules: "recursive"
       - uses: ./.github/actions/install-go
       - run: go mod tidy -v
       - run: git diff --exit-code

.github/workflows/docsgen-cli.yml

@@ -0,0 +1,34 @@
+name: Generate Documentation
+
+permissions:
+  contents: write
+
+on:
+  pull_request:
+    types: [closed]
+    branches:
+      - master
+
+jobs:
+  generate-docs:
+    if: github.event.pull_request.merged == true
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Generate documentation
+        run: make docsgen-cli
+
+      - name: Commit and push generated docs
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            git config user.name "GitHub Actions"
+            git config user.email noreply@github.com
+            git add .
+            git commit --amend --no-edit
+            git push --force
+          else
+            echo "No changes to commit"
+          fi