use githubs action to publish doc

Author: ryanseq-gyg

.github/workflows/main.yaml

@@ -56,6 +56,10 @@ jobs:
     env:
       PYTHON_VERSION: "3.11"  # Use a single version for docs
     needs: [test, lint]
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
     steps:
       - uses: actions/checkout@v4
       - name: Install Python and UV
@@ -70,10 +74,12 @@ jobs:
           uv run sphinx-build source build/html
           touch build/html/.nojekyll
         working-directory: docs
-      - name: Deploy to GitHub Pages
+      - name: Upload artifact
         if: github.ref == 'refs/heads/main'
-        uses: peaceiris/actions-gh-pages@v3
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/build/html
-          force_orphan: true
+          path: ./docs/build/html
+      - name: Deploy to GitHub Pages
+        if: github.ref == 'refs/heads/main'
+        id: deployment
+        uses: actions/deploy-pages@v4