fix(ci): deploy pages via pull request with auto-merge

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: skjnldsv

.github/workflows/sphinxbuild.yml

@@ -248,15 +248,25 @@ jobs:
         mkdir -p server/${{ steps.branch.outputs.branch_name }}/user_manual
         mv user_manual/index.html server/${{ steps.branch.outputs.branch_name }}/user_manual/index.html
 
-    - name: Commit ${{ steps.branch.outputs.branch_name }} documentation and push to gh-pages
-      run: |
-        git config --local user.email "nextcloud-command@users.noreply.github.com"
-        git config --local user.name "nextcloud-command"
-        git add .
-        git diff --staged --quiet || git commit -m "chore: deploy documentation for ${{ steps.branch.outputs.branch_name }}"
-        # Ensure we are up to date with the remote gh-pages branch
-        git pull --rebase origin gh-pages || true
-        git push origin gh-pages || echo "Nothing to push (expected if no changes)"
+    - name: Create Pull Request for documentation deployment
+      uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0 # v8.1.0
+      id: cpr
+      with:
+        token: ${{ secrets.COMMAND_BOT_PAT }}
+        commit-message: "chore: deploy documentation for ${{ steps.branch.outputs.branch_name }}"
+        committer: nextcloud-command <nextcloud-command@users.noreply.github.com>
+        author: nextcloud-command <nextcloud-command@users.noreply.github.com>
+        signoff: true
+        branch: "automated/deploy/documentation-${{ steps.branch.outputs.branch_name }}"
+        base: gh-pages
+        title: "Deploy documentation for ${{ steps.branch.outputs.branch_name }}"
+        body: "Automated documentation deployment from branch ${{ github.ref_name }}"
+        delete-branch: true
+        labels: "automated, 3. to review"
+
+    - name: Enable Pull Request Automerge
+      run: gh pr merge --merge --auto "${{ steps.cpr.outputs.pull-request-number }}"
+      if: steps.cpr.outputs.pull-request-number != ''
       env:
         GH_TOKEN: ${{ secrets.COMMAND_BOT_PAT }}