Update documentation workflow

Author: FantasyTeddy

.documentation/.gitignore

@@ -6,4 +6,5 @@
 /**/packages/
 /**/bin/
 /**/obj/
-_site
+/_site
+/api

.documentation/api/.gitignore

@@ -3,33 +3,23 @@
     {
       "src": [
         {
-          "files": "Storage.csproj",
-          "exclude": [
-            "**/bin/**",
-            "**/obj/**"
-          ],
-          "src": "../Storage"
+          "src": "../Storage",
+          "files": [
+            "**/*.csproj"
+          ]
         }
       ],
-      "dest": "api",
-      "disableGitFeatures": false,
-      "disableDefaultFilter": false
+      "dest": "api"
     }
   ],
   "build": {
     "content": [
       {
         "files": [
-          "api/**.yml",
-          "api/index.md"
-        ]
-      },
-      {
-        "files": [
-          "articles/**.md",
-          "articles/**/toc.yml",
-          "toc.yml",
-          "*.md"
+          "**/*.{md,yml}"
+        ],
+        "exclude": [
+          "_site/**"
         ]
       }
     ],
@@ -40,28 +30,15 @@
         ]
       }
     ],
-    "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": "storage-csharp",
+      "_appTitle": "storage-csharp",
+      "_enableSearch": true
+    }
   }
 }

.documentation/api/index.md

@@ -1,4 +1,5 @@
-# This is the **HOMEPAGE**.
-Refer to [Markdown](http://daringfireball.net/projects/markdown/) for how to write markdown files.
-## Quick Start Notes:
-1. Add images to the *images* folder if the file is referencing an image.
+---
+_layout: landing
+---
+
+# storage-csharp

.documentation/articles/intro.md

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

.documentation/articles/toc.yml

@@ -10,20 +10,23 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
-          submodules: "true"
           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 }}