[fix]: try to fix docs workflow permissions (#372)

use `contents: write` permissions so the deploy to the `gh-pages` branch
succeeds

Author: jamieQ

.github/workflows/docs.yaml

@@ -2,7 +2,6 @@ name: Generate and publish docs
 
 permissions:
   contents: read
-  pull-requests: write
 
 on:
   push:
@@ -18,6 +17,10 @@ jobs:
     # macos-15 is required for Xcode 16.3
     runs-on: macos-15
 
+    permissions:
+      # Needed to push to gh-pages branch
+      contents: write
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4