Migrating documentation from docfx.console to docfx

Author: tpeczek

.github/workflows/codeql.yml

@@ -1,46 +1,37 @@
 name: DocFx
 on: workflow_dispatch
+permissions:
+  contents: read
+  pages: write
+  id-token: write
 jobs:
   build:
     runs-on: windows-latest
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
-    - name: Setup .NET 6.0 SDK
-      uses: actions/setup-dotnet@v4
-      with:
-        dotnet-version: '6.0.x'
-    - name: Setup .NET 7.0 SDK
-      uses: actions/setup-dotnet@v4
-      with:
-        dotnet-version: '7.0.x'
+      uses: actions/checkout@v6
     - name: Setup .NET 8.0 SDK
-      uses: actions/setup-dotnet@v4
+      uses: actions/setup-dotnet@v5
       with:
         dotnet-version: '8.0.x'
-    - name: Restore
-      run: dotnet restore
-    - name: Build
-      run: dotnet build --configuration Release --no-restore
-    - name: Upload Artifacts
-      uses: actions/upload-artifact@v4
+    - name: Setup .NET 9.0 SDK
+      uses: actions/setup-dotnet@v5
       with:
-        name: docfx
-        path: DocFx.AspNetCore.ServerSentEvents/wwwroot
-        retention-days: 1
-  publish:
-    needs: [build]
-    runs-on: ubuntu-latest
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v4
-    - name: Download Artifacts
-      uses: actions/download-artifact@v4
+        dotnet-version: '9.0.x'
+    - name: Setup .NET 10.0 SDK
+      uses: actions/setup-dotnet@v5
       with:
-        name: docfx
-        path: DocFx.AspNetCore.ServerSentEvents/wwwroot
-    - name: Publish
-      uses: JamesIves/[email protected]
+        dotnet-version: '10.0.x'
+    - name: Setup docfx
+      run: dotnet tool update -g docfx
+    - name: Restore .NET Projects
+      run: dotnet restore
+    - name: Build Documentation Artifact
+      run: docfx docs/docfx.json
+    - name: Upload Documentation Artifact
+      uses: actions/upload-pages-artifact@v4
       with:
-        branch: gh-pages
-        folder: DocFx.AspNetCore.ServerSentEvents/wwwroot
+        path: 'docs/_artifact'
+    - name: Deploy Documentation Artifact to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v4

.github/workflows/gh-pages.yml

@@ -28,9 +28,8 @@ bld/
 #wwwroot/
 
 # DocFX generated stuff
-DocFx.AspNetCore.ServerSentEvents/log.txt
-DocFx.AspNetCore.ServerSentEvents/api/
-DocFx.AspNetCore.ServerSentEvents/wwwroot/
+/docs/api
+/docs/_artifact
 
 # MSTest test Results
 [Tt]est[Rr]esult*/