Merge pull request #18 from NgrDavid/main

Fix GitHub Actions version specificity and update to modern GitHub Pages deployment

Author: glopesdev

.github/workflows/build.yml

@@ -1,31 +1,40 @@
-# Builds and publishes the documentation website to gh-pages branch
+# Builds and publishes the documentation website
 name: Build docs
 
 on:
   push:
     branches: [ main ]
   workflow_dispatch:
 
+concurrency:
+  group: build
+  cancel-in-progress: true
+
+permissions:
+  # Both required by actions/deploy-pages
+  pages: write
+  id-token: write
+
 jobs:
   build:
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         name: Checkout
         with:
           submodules: recursive
 
       - name: Setup .NET Core SDK
-        uses: actions/setup-dotnet@v3.2.0
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 7.x
 
       - name: Custom Build Steps
         run: .\build.ps1
 
       - name: Setup MSBuild
-        uses: microsoft/setup-msbuild@v1
-      
+        uses: microsoft/setup-msbuild@v2
+
       - name: Restore NuGet Packages
         run: msbuild -t:restore src\harp\Bonsai.Harp.sln
 
@@ -34,15 +43,9 @@ jobs:
 
       - name: Build Documentation
         run: dotnet docfx docfx.json
-          
-      - name: Checkout gh-pages
-        uses: actions/checkout@v2
-        with:
-          ref: gh-pages
-          path: gh-pages
-      - name: Publish to github pages
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: _site
-          force_orphan: true
+
+      - name: Upload GitHub Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4