From dcbe06bbe4f7f064c0c7a0ae2e80bf3d09cb9d12 Mon Sep 17 00:00:00 2001
From: "Eric St. John" <ericstj@microsoft.com>
Date: Tue, 14 Oct 2025 15:21:42 -0700
Subject: [PATCH 1/2] Emit a file that lists which packages don't use
 ///-source-of-truth

---
 ...icrosoft.Internal.Runtime.DotNetApiDocs.Transport.proj | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj b/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
index 6e0335216c3b51..3fb1d6715a4dd5 100644
--- a/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
+++ b/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
@@ -36,6 +36,7 @@
       <TfmSpecificPackageFile Include="@(ReferenceAssemblyFile);
                                        @(CompilerGeneratedXmlDocFile)"
                               PackagePath="ref\$(NetCoreAppCurrent)\" />
+      <NoDocPackages Include="@(ProjectReferenceCopyLocalPathNonPrivate->WithoutMetadataValue('UseCompilerGeneratedDocXmlFile', 'true')->WithMetadataValue('IsPackable', 'true')->'%(PackageId)'->Distinct())" />
     </ItemGroup>
 
     <ItemGroup>
@@ -46,6 +47,13 @@
       <PlatformNotSupportedCompilerGeneratedXmlDocFile Remove="@(PlatformNotSupportedCompilerGeneratedXmlDocFile->WithMetadataValue('SuppressPlatformNotSupportedAssemblyDocXmlError', 'true'))" />
     </ItemGroup>
 
+    <WriteLinesToFile Lines="@(NoDocPackages)"
+                      File="$(OutputPath)NoDocPackages.txt"
+                      Overwrite="true" />
+    <ItemGroup>
+      <TfmSpecificPackageFile Include="$(OutputPath)NoDocPackages.txt" PackagePath="ref\$(NetCoreAppCurrent)\" />
+    </ItemGroup>
+
     <Error Text="Compiler generated XML documentation files are missing data because partial facade assemblies aren't supported by the repo infrastructure. Consider removing the partial facade feature. Assemblies: @(PartialFacadeCompilerGeneratedXmlDocFile->Metadata('Filename'), ', ')."
            Condition="'@(PartialFacadeCompilerGeneratedXmlDocFile)' != ''" />
 

From 883c208a4866c8052e49dbcd368fa05ddfd2a88c Mon Sep 17 00:00:00 2001
From: "Eric St. John" <ericstj@microsoft.com>
Date: Thu, 16 Oct 2025 16:59:12 -0700
Subject: [PATCH 2/2] Use ReferencePath to identify packages without compiler
 generated docs

We were missing non-copy-local assemblies (EG: framework overlapping) that had packages.
EG:
System.Collections.Immutable
System.Text.Json
etc
---
 .../src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj b/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
index 3fb1d6715a4dd5..bb50fb1df296c9 100644
--- a/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
+++ b/src/libraries/Microsoft.Internal.Runtime.DotNetApiDocs.Transport/src/Microsoft.Internal.Runtime.DotNetApiDocs.Transport.proj
@@ -36,7 +36,7 @@
       <TfmSpecificPackageFile Include="@(ReferenceAssemblyFile);
                                        @(CompilerGeneratedXmlDocFile)"
                               PackagePath="ref\$(NetCoreAppCurrent)\" />
-      <NoDocPackages Include="@(ProjectReferenceCopyLocalPathNonPrivate->WithoutMetadataValue('UseCompilerGeneratedDocXmlFile', 'true')->WithMetadataValue('IsPackable', 'true')->'%(PackageId)'->Distinct())" />
+      <NoDocPackages Include="@(ReferencePath->WithoutMetadataValue('UseCompilerGeneratedDocXmlFile', 'true')->WithMetadataValue('IsPackable', 'true')->'%(PackageId)'->Distinct())" />
     </ItemGroup>
 
     <ItemGroup>