Deploy documentation in a different way

Author: Joaopeuko

.github/workflows/deploy-mkdocs.yml

@@ -6,11 +6,16 @@ on:
     branches: ['*'] # <<<<<<<<< Return this to main before merging
 
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
 
 jobs:
   deploy:
     runs-on: windows-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -23,5 +28,17 @@ jobs:
       - name: Install the project
         run: uv sync --locked --group docs
 
-      - name: Deploy MkDocs
-        run: mkdocs gh-deploy --force
+      - name: Build MkDocs
+        run: mkdocs build --site-dir ./deploy
+      
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './deploy'
+          
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4