Update docs.yml

.github/workflows/docs.yml

@@ -11,7 +11,7 @@ on:
 
 # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
-  contents: read
+  contents: write
   pages: write
   id-token: write
 
@@ -31,16 +31,17 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - name: Generate docs
-        uses: ammaraskar/sphinx-action@master
-        with:
-          docs-folder: "docs/"
-      - uses: actions/upload-artifact@v3
-        with:
-          name: "stitch-docs"
-          path: "docs/_build/html/"
+      - uses: actions/setup-python@v5
+      - name: Install dependencies
+        run: |
+          pip install sphinx
+      - name: Sphinx build
+        run: |
+          sphinx-build docs _build
       - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
+        uses: peaceiris/actions-gh-pages@v3
         with:
-          artifact_name: "stitch-docs"
+          publish_branch: gh-pages
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: _build/
+          force_orphan: true