Update documentation workflow

Author: FantasyTeddy

.documentation/docfx.json

@@ -1,55 +1,44 @@
 {
-  "metadata": [{
-    "src": [{
-      "files": "Postgrest.csproj",
-      "exclude": ["**/bin/**", "**/obj/**"],
-      "src": "../Postgrest"
-    }],
-    "dest": "api",
-    "disableGitFeatures": false,
-    "disableDefaultFilter": false
-  }],
+  "metadata": [
+    {
+      "src": [
+        {
+          "src": "../Postgrest",
+          "files": [
+            "**/*.csproj"
+          ]
+        }
+      ],
+      "dest": "api"
+    }
+  ],
   "build": {
-    "content": [{
+    "content": [
+      {
         "files": [
-          "api/**.yml",
-          "api/index.md"
+          "**/*.{md,yml}"
+        ],
+        "exclude": [
+          "_site/**"
         ]
-      },
+      }
+    ],
+    "resource": [
       {
         "files": [
-          "articles/**.md",
-          "articles/**/toc.yml",
-          "toc.yml",
-          "*.md"
+          "images/**"
         ]
       }
     ],
-    "resource": [{
-      "files": [
-        "images/**"
-      ]
-    }],
-    "overwrite": [{
-      "files": [
-        "apidoc/**.md"
-      ],
-      "exclude": [
-        "obj/**",
-        "_site/**"
-      ]
-    }],
-    "dest": "_site",
-    "globalMetadataFiles": [],
-    "fileMetadataFiles": [],
+    "output": "_site",
     "template": [
-      "default"
+      "default",
+      "modern"
     ],
-    "postProcessors": [],
-    "markdownEngineName": "markdig",
-    "noLangKeyword": false,
-    "keepFileLink": false,
-    "cleanupCacheHistory": false,
-    "disableGitFeatures": false
+    "globalMetadata": {
+      "_appName": "postgrest-csharp",
+      "_appTitle": "postgrest-csharp",
+      "_enableSearch": true
+    }
   }
 }

.documentation/index.md

@@ -1,3 +1,7 @@
+---
+_layout: landing
+---
+
 # postgrest-csharp
 
 ![Build And Test](https://github.com/supabase/postgrest-csharp/workflows/Build%20And%20Test/badge.svg)

.documentation/toc.yml

@@ -1,5 +1,2 @@
-- name: Articles
-  href: articles/
-- name: Api Documentation
+- name: API
   href: api/
-  homepage: api/index.md

.github/workflows/build-documentation.yaml

@@ -10,19 +10,23 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
           persist-credentials: false
 
-      - uses: nikeee/docfx-action@v1.0.0
-        name: Build Documentation
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v3
         with:
-          args: .documentation/docfx.json
+          dotnet-version: 8.x
+
+      - name: Install docfx
+        run: dotnet tool update -g docfx
+
+      - name: Build documentation
+        run: docfx .documentation/docfx.json
 
       - name: Deploy 🚀
-        uses: JamesIves/github-pages-deploy-action@3.7.1
+        uses: JamesIves/github-pages-deploy-action@v4
         with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          BRANCH: gh-pages
-          FOLDER: .documentation/_site # The folder the action should deploy.
-          CLEAN: true # Automatically remove deleted files from the deploy branch
+          folder: .documentation/_site
+          token: ${{ secrets.GITHUB_TOKEN }}