Fix actions version specificity and update to modern pages deployment

.github/workflows/docs.yml

@@ -1,51 +1,56 @@
-# Builds and publishes the documentation website to gh-pages branch
+# Builds and publishes the documentation website
 name: Build docs
 
 on:
   workflow_dispatch:
 
+concurrency:
+  group: docs
+  cancel-in-progress: true
+
+permissions:
+  # Both required by actions/deploy-pages
+  pages: write
+  id-token: write
+
 jobs:
   build:
     runs-on: windows-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.1.1
+        uses: actions/checkout@v4
         with:
           submodules: true
-        
+
       - name: Setup MSBuild
         uses: microsoft/setup-msbuild@v2
-        
+
       - name: Restore NuGet Packages
         run: msbuild -t:restore src/Bonsai.Scripting.Python.sln
 
       - name: Build Solution
         run: msbuild src/Bonsai.Scripting.Python.sln /p:Configuration=Release
 
       - name: Setup .NET Core SDK
-        uses: actions/setup-dotnet@v4.0.0
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 7.x
-        
+
       - name: Setup DocFX
         run: dotnet tool restore
 
       - name: Setup Bonsai
         working-directory: .bonsai
         run: .\Setup.ps1
-        
+
       - name: Build Documentation
         working-directory: docs
         run: .\build.ps1
-
-      - name: Checkout gh-pages
-        uses: actions/[email protected]
-        with:
-          ref: gh-pages
-          path: gh-pages
-      - name: Publish to github pages
-        uses: peaceiris/[email protected]
+
+      - name: Upload GitHub Pages Artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/_site
-          force_orphan: true
+          path: docs/_site
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4