fix: full DocFX build with multi-repo checkout

Author: Jani Giannoudis

.github/workflows/pages.yml

@@ -21,18 +21,48 @@ jobs:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Client.Scripting
+        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'
+
+      - name: Configure GitHub Packages source
+        run: |
+          dotnet nuget add source \
+            "https://nuget.pkg.github.com/Payroll-Engine/index.json" \
+            --name github --username github-actions \
+            --password ${{ secrets.PAT_DISPATCH }} \
+            --store-password-in-clear-text
 
       - name: Install DocFX
         run: dotnet tool install -g docfx
 
       - name: Build DocFX
-        run: cd docfx && docfx docfx.pages.json
+        run: cd PayrollEngine.Client.Scripting/docfx && docfx docfx.json --outputFolder _site
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: docfx/_site
+          path: PayrollEngine.Client.Scripting/docfx/_site
 
       - name: Deploy to GitHub Pages
         id: deployment