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

Author: bkoelman

docs/.gitignore

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

docs/build-dev.ps1

@@ -9,12 +9,25 @@ param(
     [switch] $NoOpen=$False
 )
 
+# workaround for bug at https://github.com/PowerShell/PowerShell/issues/23875#issuecomment-2672336383
+$PSDefaultParameterValues['Remove-Item:ProgressAction'] = 'SilentlyContinue'
+
 function VerifySuccessExitCode {
     if ($LastExitCode -ne 0) {
         throw "Command failed with exit code $LastExitCode."
     }
 }
 
+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 $zipFile)) {
+        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."
@@ -25,9 +38,13 @@ function EnsureHttpServerIsInstalled {
 
     if ($LastExitCode -eq 1) {
         npm install -g httpserver
+        VerifySuccessExitCode
     }
 }
 
+EnsureDocfxBinaries
+VerifySuccessExitCode
+
 EnsureHttpServerIsInstalled
 VerifySuccessExitCode
 
@@ -46,7 +63,7 @@ dotnet tool restore
 VerifySuccessExitCode
 
 $env:DOCFX_SOURCE_BRANCH_NAME="dev"
-dotnet docfx ./docfx.json --warningsAsErrors true
+docfx-net10-binaries/docfx ./docfx.json --warningsAsErrors true
 VerifySuccessExitCode
 
 Copy-Item -Force home/*.html _site/