docs: switch back to using docfx tool

Author: egil

.config/dotnet-tools.json

@@ -7,6 +7,12 @@
       "commands": [
         "dotnet-serve"
       ]
+    },
+    "docfx": {
+      "version": "2.74.1",
+      "commands": [
+        "docfx"
+      ]
     }
   }
 }

.github/workflows/ci.yml

@@ -218,14 +218,17 @@ jobs:
           files: '["docs/site/*.md", "docs/**/*.md", "docs/**/*.tmpl.partial", "*.csproj", "**/*.csproj"]'
 
       - name: 📄 Build bUnit
-        run: dotnet build
+        run: dotnet build -c release
 
       - name: 🧪 Run sample unit tests
         run: dotnet test docs/samples/samples.sln
 
       - name: 📄 Build docs
         working-directory: ./docs/site
-        run: dotnet run Site.csproj
+        run: |
+          dotnet tool install --global docfx --version 2.74.1
+          docfx metadata
+          docfx build
 
   dependency-review:
     runs-on: ubuntu-latest

.github/workflows/docs-deploy.yml

@@ -84,14 +84,17 @@ jobs:
           echo "TERM=xterm" >> $GITHUB_ENV
 
       - name: 🛠️ Building bUnit
-        run: dotnet build /p:PublicRelease=true
+        run: dotnet build /p:PublicRelease=true -c release
 
       - name: 🛠️ Verify docs samples
         run: dotnet test docs/samples/samples.sln
 
       - name: 📄 Building docs
         working-directory: ./docs/site
-        run: dotnet run Site.csproj
+        run: |
+          dotnet tool install --global docfx --version 2.74.1
+          docfx metadata
+          docfx build
 
       - name: 🛠️ Deploy to GitHub Pages
         if: success()

docs/site/Site.csproj

@@ -5,8 +5,8 @@
       "src": [
         {
           "files": [
-            "bunit.core/bunit.core.csproj",
-            "bunit.web/bunit.web.csproj"
+            "bunit.core/**/bin/Release/**.dll",
+            "bunit.web/**/bin/Release/**.dll"
           ],
           "src": "../../src"
         }