Add temporary workaround until docfx version is available that is compatible with .NET 10

Author: bkoelman

.github/workflows/build.yml

@@ -128,8 +128,11 @@ jobs:
         $ErrorActionPreference = "Stop"
         $PSNativeCommandUseErrorActionPreference = $true
         cd docs
+        $zipFile = [IO.Path]::Combine($env:TEMP, 'docfx-net10-binaries.zip')
+        Invoke-WebRequest -Uri 'https://github.com/json-api-dotnet/docfx/raw/refs/heads/dotnet10-rtm/net10-binaries.zip' -Method 'GET' -OutFile $zipFile
+        Expand-Archive $zipFile -Force
         & ./generate-examples.ps1
-        dotnet docfx docfx.json --warningsAsErrors true
+        docfx-net10-binaries/docfx docfx.json --warningsAsErrors true
         Copy-Item CNAME _site/CNAME
         Copy-Item home/*.html _site/
         Copy-Item home/*.ico _site/

docs/.gitignore

@@ -3,3 +3,4 @@ api/*.yml
 api/.manifest
 request-examples/*.json
 request-examples/*.temp
+docfx-net10-binaries/

docs/build-dev.ps1

@@ -15,6 +15,16 @@ $PSNativeCommandUseErrorActionPreference = $true
 # Workaround for bug at https://github.com/PowerShell/PowerShell/issues/23875#issuecomment-2672336383
 $PSDefaultParameterValues['Remove-Item:ProgressAction'] = 'SilentlyContinue'
 
+function EnsureDocfxBinaries() {
+    # Temporary workaround until a proper DocFX build supporting .NET 10 is available.
+    $zipFile = [IO.Path]::Combine($env:TEMP, 'docfx-net10-binaries.zip')
+
+    if (!(Test-Path -Path 'docfx-net10-binaries')) {
+        Invoke-WebRequest -Uri 'https://github.com/json-api-dotnet/docfx/raw/refs/heads/dotnet10-rtm/net10-binaries.zip' -Method 'GET' -OutFile $zipFile
+        Expand-Archive $zipFile -Force
+    }
+}
+
 function EnsureHttpServerIsInstalled {
     if ((Get-Command "npm" -ErrorAction SilentlyContinue) -eq $null) {
         throw "Unable to find npm in your PATH. please install Node.js first."
@@ -45,6 +55,7 @@ function EnsureHttpServerIsInstalled {
     }
 }
 
+EnsureDocfxBinaries
 EnsureHttpServerIsInstalled
 
 if (-Not $NoBuild -Or -Not (Test-Path -Path _site)) {
@@ -58,7 +69,7 @@ if (-Not $NoBuild -Or -Not (Test-Path -Path _site)) {
 dotnet tool restore
 
 $env:DOCFX_SOURCE_BRANCH_NAME="dev"
-dotnet docfx docfx.json --warningsAsErrors true
+docfx-net10-binaries/docfx docfx.json --warningsAsErrors true
 
 Copy-Item -Force home/*.html _site/
 Copy-Item -Force home/*.ico _site/