Try generating from source files.

Try excluding current first project that fails.
Remove parallel options and set timeout lower than AzureDevOps task timeout to get diagnostic output.
2025-12-12 15:45:27 +01:00 · 2025-12-12 15:14:13 +01:00 · 2025-12-12 13:58:00 +01:00 · 2025-12-12 13:15:33 +01:00 · 2025-12-12 08:03:45 +01:00 · 2025-12-11 22:43:47 +01:00
2 changed files with 13 additions and 7 deletions
@@ -215,7 +215,7 @@ stages:
            inputs:
              targetType: inline
              script: |
-                choco install docfx --version=2.59.4 -y
+                dotnet tool update -g docfx
                if ($lastexitcode -ne 0){
                    throw ("Error installing DocFX")
                }
@@ -224,10 +224,14 @@ stages:
            inputs:
              targetType: inline
              script: |
+                # Using .cs files directly instead of .csproj to avoid MSBuild/NBGV hangs on Azure DevOps
+                # See: https://github.com/dotnet/docfx/issues/10144
+                Write-Host "Starting docfx metadata generation from source files..."
                docfx metadata "$(Build.SourcesDirectory)/build/csharp-docs/docfx.json"
                if ($lastexitcode -ne 0){
                    throw ("Error generating metadata.")
                }
+            timeoutInMinutes: 30
          - task: PowerShell@2
            displayName: Generate documentation
            inputs:
@@ -5,20 +5,22 @@
        {
          "src": "../../src",
          "files": [
-            "**/*.csproj"
+            "**/*.cs"
          ],
          "exclude": [
            "**/obj/**",
            "**/bin/**",
-            "**/Umbraco.Web.csproj",
-            "**/Umbraco.Web.UI.csproj",
-            "**/Umbraco.Cms.StaticAssets.csproj",
-            "**/JsonSchema.csproj"
+            "**/Umbraco.Web.UI/**",
+            "**/Umbraco.Cms.StaticAssets/**",
+            "**/Umbraco.Cms/**",
+            "**/Umbraco.Cms.Targets/**"
          ]
        }
      ],
      "dest": "api",
-      "filter": "docfx.filter.yml"
+      "filter": "docfx.filter.yml",
+      "disableGitFeatures": true,
+      "maxParallelism": 1
    }
  ],
  "build": {
Author	SHA1	Message	Date
Andy Butland	4737b48c8a	Try generating from source files.	2025-12-12 15:45:27 +01:00
Andy Butland	90962b79eb	Try excluding current first project that fails.	2025-12-12 15:14:13 +01:00
Andy Butland	7ac212c95f	Remove parallel options and set timeout lower than AzureDevOps task timeout to get diagnostic output.	2025-12-12 13:58:00 +01:00
Andy Butland	5734934952	Reset to latest version.	2025-12-12 13:15:33 +01:00
Andy Butland	cc962c860f	Remove noRestore.	2025-12-12 08:03:45 +01:00
Andy Butland	71611fda2c	Used older version of docfx.	2025-12-11 22:43:47 +01:00
Andy Butland	6104e01641	Disable git versioning (2).	2025-12-11 21:48:45 +01:00
Andy Butland	d6c70aa8e6	Disable git versioning.	2025-12-11 21:16:09 +01:00
Andy Butland	cd25e66724	Exclude meta projects.	2025-12-11 20:39:49 +01:00
Andy Butland	011cf5fde5	Attempts to speed up running on pipeline.	2025-12-11 18:30:08 +01:00
Andy Butland	5a12c62a41	Use dotnet tool for install and use latest docfx version.	2025-12-11 15:56:12 +01:00