linq2db · MaceWindu · Aug 13, 2026 · Aug 13, 2026 · Aug 13, 2026
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/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.NET.StringTools.dll b/docfx/Microsoft.NET.StringTools.dll
diff --git a/docfx/Microsoft.Playwright.dll b/docfx/Microsoft.Playwright.dll
diff --git a/docfx/README.md b/docfx/README.md
@@ -12,30 +12,37 @@ 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
+- **`assemblyUids`** — the assemblies whose APIs carry the assembly they are declared in as a component of
+  their UID, as in `linq2db.Tools::LinqToDB.Tools.Activity.ActivityStatistics`. It sits at the top level of
+  `docfx.json` next to `metadata`, because every metadata entry has to agree: an entry mints UIDs for the
+  APIs it references as well as the ones it documents.
+- **`assemblyUidOverride`** — the component to use for the assemblies one 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
+  `LinqToDB.EntityFrameworkCore.props`), so they cannot be told apart by assembly name and this is the only
   thing that separates them.
 
+The assembly is a component of the identity, not a namespace segment: `LinqToDB` still reads as `LinqToDB`
+in titles, breadcrumbs and links, and only the UID and the file name carry the assembly (`::` becomes `--`
+in file names, as `:` is not legal there).
+
 This replaces the older `globalPrefix` hack, which produced a malformed `commentId`, unprefixed
-namespace and type hrefs, and ~1200 dead in-page anchors.
+namespace and type hrefs, and ~1200 dead in-page anchors, and the `assemblyUidPrefixes` /
+`uidPrefixOverride` pair before it, which spelled the assembly as a leading namespace segment and so
+surfaced in page titles and the table of contents as a namespace that does not exist.
 
 ## 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.
+Branch: [`fix/8966-uid-prefixes`](https://github.com/MaceWindu/docfx/pull/2) in
+<https://github.com/MaceWindu/docfx>, currently `9907932d6` — the branch proposed for upstream, with
+nothing added on top.
 
-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.
+The previous build needed one extra commit bumping Roslyn to 5.6.0, because with Roslyn 5.0.0 and the
+.NET 10 SDK opening the linq2db projects failed with `System.TimeoutException` from
+`MSBuildProjectLoader`'s BuildHost. Upstream has since taken that bump (dotnet/docfx#11047), so no custom
+commit is required any more.
 
 ```powershell
-git clone https://github.com/MaceWindu/docfx -b custom/linq2db-uidprefix
+git clone https://github.com/MaceWindu/docfx -b fix/8966-uid-prefixes
 cd docfx/templates; npm ci; npm run build; cd ..
 dotnet build src/docfx/docfx.csproj -c Release -f net10.0
 
@@ -48,11 +55,11 @@ dotnet build src/docfx/docfx.csproj -c Release -f net10.0
 `docfx.exe --version` prints the source commit, so the vendored build can always be traced back:
 
 ```
-1.0.0+91955d98af242864651de19b5f94f40d1ba47ad2
+1.0.0+9907932d6be6ad503885fc5c3c166ae4ce952be9
 ```
 
 ## When can this go away
 
-Once `assemblyUidPrefixes` and `uidPrefixOverride` ship in a released docfx, drop this folder and switch
+Once `assemblyUids` and `assemblyUidOverride` 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.Ansi.dll b/docfx/Spectre.Console.Ansi.dll
diff --git a/docfx/Spectre.Console.Cli.dll b/docfx/Spectre.Console.Cli.dll
diff --git a/docfx/Spectre.Console.dll b/docfx/Spectre.Console.dll
diff --git a/docfx/System.Configuration.ConfigurationManager.dll b/docfx/System.Configuration.ConfigurationManager.dll
diff --git a/docfx/System.Reflection.MetadataLoadContext.dll b/docfx/System.Reflection.MetadataLoadContext.dll
diff --git a/docfx/System.Security.Cryptography.ProtectedData.dll b/docfx/System.Security.Cryptography.ProtectedData.dll