fix: DocFX reads DLL instead of csproj to avoid C#14/version issues

Author: Jani Giannoudis

.github/workflows/pages.yml

@@ -21,29 +21,13 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - name: Checkout Client.Scripting
+      - name: Checkout
         uses: actions/checkout@v4
-        with:
-          path: PayrollEngine.Client.Scripting
-
-      - name: Checkout Core
-        uses: actions/checkout@v4
-        with:
-          repository: Payroll-Engine/PayrollEngine.Core
-          token: ${{ secrets.PAT_DISPATCH }}
-          path: PayrollEngine.Core
-
-      - name: Checkout Client.Core
-        uses: actions/checkout@v4
-        with:
-          repository: Payroll-Engine/PayrollEngine.Client.Core
-          token: ${{ secrets.PAT_DISPATCH }}
-          path: PayrollEngine.Client.Core
 
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: '10.0.x'
+          dotnet-version: '9.0.x'
 
       - name: Configure GitHub Packages source
         run: |
@@ -53,19 +37,19 @@ jobs:
             --password ${{ secrets.PAT_DISPATCH }} \
             --store-password-in-clear-text
 
+      - name: Build
+        run: dotnet build Client.Scripting/PayrollEngine.Client.Scripting.csproj -c Release
+
       - name: Install DocFX
         run: dotnet tool install -g docfx
 
-      - name: Restore NuGet packages
-        run: dotnet restore PayrollEngine.Client.Scripting/Client.Scripting/
-
       - name: Build DocFX
-        run: cd PayrollEngine.Client.Scripting/docfx && docfx docfx.json
+        run: cd docfx && docfx docfx.json
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: PayrollEngine.Client.Scripting/docfx/_site
+          path: docfx/_site
 
       - name: Deploy to GitHub Pages
         id: deployment

docfx/docfx.json

@@ -3,18 +3,16 @@
     {
       "src": [
         {
-          "files": [ "**.csproj" ],
-          "src": "../Client.Scripting/"
+          "files": [ "**/bin/Release/net9.0/PayrollEngine.Client.Scripting.dll" ],
+          "src": "../../"
         }
       ],
       "dest": "api",
       "includePrivateMembers": false,
       "disableGitFeatures": false,
       "disableDefaultFilter": false,
-      "noRestore": false,
       "namespaceLayout": "flattened",
       "memberLayout": "samePage",
-      "allowCompilationErrors": false,
       "filter": "filterConfig.yml"
     }
   ],