linq2db · MaceWindu · Aug 9, 2026 · Aug 8, 2026 · Aug 8, 2026 · Aug 8, 2026
diff --git a/docfx/BuildHost-net472/System.ValueTuple.dll b/docfx/BuildHost-net472/System.ValueTuple.dll
diff --git a/docfx/Docfx.App.dll b/docfx/Docfx.App.dll
diff --git a/docfx/Docfx.App.pdb b/docfx/Docfx.App.pdb
diff --git a/docfx/Docfx.Build.Common.dll b/docfx/Docfx.Build.Common.dll
diff --git a/docfx/Docfx.Build.Common.pdb b/docfx/Docfx.Build.Common.pdb
diff --git a/docfx/Docfx.Build.ManagedReference.dll b/docfx/Docfx.Build.ManagedReference.dll
diff --git a/docfx/Docfx.Build.ManagedReference.pdb b/docfx/Docfx.Build.ManagedReference.pdb
diff --git a/docfx/Docfx.Build.OverwriteDocuments.dll b/docfx/Docfx.Build.OverwriteDocuments.dll
diff --git a/docfx/Docfx.Build.OverwriteDocuments.pdb b/docfx/Docfx.Build.OverwriteDocuments.pdb
diff --git a/docfx/Docfx.Build.RestApi.dll b/docfx/Docfx.Build.RestApi.dll
diff --git a/docfx/Docfx.Build.RestApi.pdb b/docfx/Docfx.Build.RestApi.pdb
diff --git a/docfx/Docfx.Build.SchemaDriven.dll b/docfx/Docfx.Build.SchemaDriven.dll
diff --git a/docfx/Docfx.Build.SchemaDriven.pdb b/docfx/Docfx.Build.SchemaDriven.pdb
diff --git a/docfx/Docfx.Build.UniversalReference.dll b/docfx/Docfx.Build.UniversalReference.dll
diff --git a/docfx/Docfx.Build.UniversalReference.pdb b/docfx/Docfx.Build.UniversalReference.pdb
diff --git a/docfx/Docfx.Build.dll b/docfx/Docfx.Build.dll
diff --git a/docfx/Docfx.Build.pdb b/docfx/Docfx.Build.pdb
diff --git a/docfx/Docfx.Common.dll b/docfx/Docfx.Common.dll
diff --git a/docfx/Docfx.Common.pdb b/docfx/Docfx.Common.pdb
diff --git a/docfx/Docfx.DataContracts.Common.dll b/docfx/Docfx.DataContracts.Common.dll
diff --git a/docfx/Docfx.DataContracts.Common.pdb b/docfx/Docfx.DataContracts.Common.pdb
diff --git a/docfx/Docfx.DataContracts.RestApi.dll b/docfx/Docfx.DataContracts.RestApi.dll
diff --git a/docfx/Docfx.DataContracts.RestApi.pdb b/docfx/Docfx.DataContracts.RestApi.pdb
diff --git a/docfx/Docfx.DataContracts.UniversalReference.dll b/docfx/Docfx.DataContracts.UniversalReference.dll
diff --git a/docfx/Docfx.DataContracts.UniversalReference.pdb b/docfx/Docfx.DataContracts.UniversalReference.pdb
diff --git a/docfx/Docfx.Dotnet.dll b/docfx/Docfx.Dotnet.dll
diff --git a/docfx/Docfx.Dotnet.pdb b/docfx/Docfx.Dotnet.pdb
diff --git a/docfx/Docfx.Glob.dll b/docfx/Docfx.Glob.dll
diff --git a/docfx/Docfx.Glob.pdb b/docfx/Docfx.Glob.pdb
diff --git a/docfx/Docfx.MarkdigEngine.Extensions.dll b/docfx/Docfx.MarkdigEngine.Extensions.dll
diff --git a/docfx/Docfx.MarkdigEngine.Extensions.pdb b/docfx/Docfx.MarkdigEngine.Extensions.pdb
diff --git a/docfx/Docfx.MarkdigEngine.dll b/docfx/Docfx.MarkdigEngine.dll
diff --git a/docfx/Docfx.MarkdigEngine.pdb b/docfx/Docfx.MarkdigEngine.pdb
diff --git a/docfx/Docfx.Plugins.dll b/docfx/Docfx.Plugins.dll
diff --git a/docfx/Docfx.Plugins.pdb b/docfx/Docfx.Plugins.pdb
diff --git a/docfx/Docfx.YamlSerialization.dll b/docfx/Docfx.YamlSerialization.dll
diff --git a/docfx/Docfx.YamlSerialization.pdb b/docfx/Docfx.YamlSerialization.pdb
diff --git a/docfx/Jint.dll b/docfx/Jint.dll
diff --git a/docfx/Markdig.dll b/docfx/Markdig.dll
diff --git a/docfx/Microsoft.Build.Framework.dll b/docfx/Microsoft.Build.Framework.dll
diff --git a/docfx/Microsoft.Build.dll b/docfx/Microsoft.Build.dll
diff --git a/docfx/Microsoft.CodeAnalysis.CSharp.Workspaces.dll b/docfx/Microsoft.CodeAnalysis.CSharp.Workspaces.dll
diff --git a/docfx/Microsoft.CodeAnalysis.CSharp.dll b/docfx/Microsoft.CodeAnalysis.CSharp.dll
diff --git a/docfx/Microsoft.CodeAnalysis.ExternalAccess.RazorCompiler.dll b/docfx/Microsoft.CodeAnalysis.ExternalAccess.RazorCompiler.dll
diff --git a/docfx/Microsoft.CodeAnalysis.VisualBasic.Workspaces.dll b/docfx/Microsoft.CodeAnalysis.VisualBasic.Workspaces.dll
diff --git a/docfx/Microsoft.CodeAnalysis.VisualBasic.dll b/docfx/Microsoft.CodeAnalysis.VisualBasic.dll
diff --git a/docfx/Microsoft.CodeAnalysis.Workspaces.MSBuild.dll b/docfx/Microsoft.CodeAnalysis.Workspaces.MSBuild.dll
diff --git a/docfx/Microsoft.CodeAnalysis.Workspaces.dll b/docfx/Microsoft.CodeAnalysis.Workspaces.dll
diff --git a/docfx/Microsoft.CodeAnalysis.dll b/docfx/Microsoft.CodeAnalysis.dll
diff --git a/docfx/Microsoft.Extensions.DependencyInjection.Abstractions.dll b/docfx/Microsoft.Extensions.DependencyInjection.Abstractions.dll
diff --git a/docfx/Microsoft.Extensions.DependencyInjection.dll b/docfx/Microsoft.Extensions.DependencyInjection.dll
diff --git a/docfx/Microsoft.Extensions.Logging.Abstractions.dll b/docfx/Microsoft.Extensions.Logging.Abstractions.dll
diff --git a/docfx/Microsoft.Extensions.Logging.dll b/docfx/Microsoft.Extensions.Logging.dll
diff --git a/docfx/Microsoft.Extensions.Options.dll b/docfx/Microsoft.Extensions.Options.dll
diff --git a/docfx/Microsoft.Extensions.Primitives.dll b/docfx/Microsoft.Extensions.Primitives.dll
diff --git a/docfx/Microsoft.NET.StringTools.dll b/docfx/Microsoft.NET.StringTools.dll
diff --git a/docfx/README.md b/docfx/README.md
@@ -0,0 +1,58 @@
+# Vendored docfx build
+
+`build.ps1` runs `./docfx/docfx` rather than the `docfx` global tool, because this site needs two
+options that are not in released docfx yet.
+
+## Why
+
+linq2db documents 17 assemblies in one docfx project and many of them declare the same namespaces, most
+of all `LinqToDB`. A docfx UID is derived from the fully qualified name of an API alone, so those APIs
+collide: pages overwrite each other, `DuplicateUids` is reported and links resolve to whichever assembly
+happened to win. See <https://github.com/dotnet/docfx/issues/8966>.
+
+`source/docfx.json` therefore uses:
+
+- **`assemblyUidPrefixes`** — maps assembly name to UID prefix, at the top level of `docfx.json` next to
+  `metadata`. It is a project level setting because every metadata entry has to agree on the prefixes: an
+  entry mints UIDs for the APIs it references as well as the ones it documents.
+- **`uidPrefixOverride`** — a per entry prefix, for the assemblies that entry documents. The four
+  Entity Framework Core entries all build an assembly named `linq2db.EntityFrameworkCore` (see
+  `LinqToDB.EntityFrameworkCore.props`), so they cannot be keyed by assembly name and this is the only
+  thing that separates them.
+
+This replaces the older `globalPrefix` hack, which produced a malformed `commentId`, unprefixed
+namespace and type hrefs, and ~1200 dead in-page anchors.
+
+## How this build is produced
+
+Branch: [`custom/linq2db-uidprefix`](https://github.com/MaceWindu/docfx/tree/custom/linq2db-uidprefix)
+in <https://github.com/MaceWindu/docfx>, currently `91955d98a`. It is
+[`fix/8966-uid-prefixes`](https://github.com/MaceWindu/docfx/pull/2) — the branch proposed for upstream
+— plus one commit bumping Roslyn to 5.6.0.
+
+The Roslyn bump is required, not cosmetic: with Roslyn 5.0.0 and the .NET 10 SDK, opening the linq2db
+projects fails with `System.TimeoutException` from `MSBuildProjectLoader`'s BuildHost. It is kept off the
+upstream branch because it would churn docfx's snapshot tests.
+
+```powershell
+git clone https://github.com/MaceWindu/docfx -b custom/linq2db-uidprefix
+cd docfx/templates; npm ci; npm run build; cd ..
+dotnet build src/docfx/docfx.csproj -c Release -f net10.0
+
+# then copy into this folder, replacing every tracked file:
+#   src/docfx/bin/Release/net10.0/*.{dll,exe,pdb,json,ps1,TXT}
+#   src/docfx/bin/Release/net10.0/{BuildHost-net472,BuildHost-netcore,templates}
+# `.playwright` is not tracked, leave it alone.
+```
+
+`docfx.exe --version` prints the source commit, so the vendored build can always be traced back:
+
+```
+1.0.0+91955d98af242864651de19b5f94f40d1ba47ad2
+```
+
+## When can this go away
+
+Once `assemblyUidPrefixes` and `uidPrefixOverride` ship in a released docfx, drop this folder and switch
+`build.ps1` back to the `docfx` global tool. The `source/docfx.json` options themselves do not need to
+change.
diff --git a/docfx/Spectre.Console.dll b/docfx/Spectre.Console.dll
diff --git a/docfx/System.Collections.Immutable.dll b/docfx/System.Collections.Immutable.dll
diff --git a/docfx/System.Composition.AttributedModel.dll b/docfx/System.Composition.AttributedModel.dll
diff --git a/docfx/System.Composition.Convention.dll b/docfx/System.Composition.Convention.dll
diff --git a/docfx/System.Composition.Hosting.dll b/docfx/System.Composition.Hosting.dll
diff --git a/docfx/System.Composition.Runtime.dll b/docfx/System.Composition.Runtime.dll
diff --git a/docfx/System.Composition.TypedParts.dll b/docfx/System.Composition.TypedParts.dll
diff --git a/docfx/System.Diagnostics.DiagnosticSource.dll b/docfx/System.Diagnostics.DiagnosticSource.dll
diff --git a/docfx/System.IO.Pipelines.dll b/docfx/System.IO.Pipelines.dll
diff --git a/docfx/System.Reflection.Metadata.dll b/docfx/System.Reflection.Metadata.dll
diff --git a/docfx/System.Security.Cryptography.ProtectedData.dll b/docfx/System.Security.Cryptography.ProtectedData.dll