Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Aug 27, 2025

This PR adds comprehensive documentation for a breaking change introduced in .NET 10 Preview 5 where NuGet packages that don't contribute runtime assets may be excluded from deps.json files.

Changes Made

New Breaking Change Document: Created docs/core/compatibility/deployment/10.0/deps-json-trimmed-packages.md that documents:

  • Previous behavior: All referenced NuGet packages and projects were included in deps.json as library entries, even without runtime assets
  • New behavior: Libraries may be excluded if they don't contribute runtime assets and their removal doesn't break dependency paths
  • Workaround: Set the TrimDepsJsonLibrariesWithoutAssets MSBuild property to false to disable the new behavior

Documentation Updates:

  • Added new "Deployment" section to the .NET 10 compatibility index (docs/core/compatibility/10.0.md)
  • Updated the table of contents (docs/core/compatibility/toc.yml) to include the new document

The documentation follows established Microsoft Writing Style Guidelines and includes proper AI usage disclosure. This change improves accuracy of dependency tracking and reduces false positives in security scanners that process deps.json files.

Example workaround:

<PropertyGroup>
  <TrimDepsJsonLibrariesWithoutAssets>false</TrimDepsJsonLibrariesWithoutAssets>
</PropertyGroup>

Fixes #48132.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/sdk/10.0/deps-json-trimmed-packages.md NuGet packages with no runtime assets aren't included in deps.json
docs/core/compatibility/toc.yml docs/core/compatibility/toc

…ps.json files

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] [Breaking change]: NuGet packages may not be included in deps.json files if no runtime assets were included from the package Add breaking change documentation for NuGet packages excluded from deps.json files Aug 27, 2025
@Copilot Copilot AI requested a review from gewarren August 27, 2025 17:40
Copilot finished work on behalf of gewarren August 27, 2025 17:40
@gewarren gewarren marked this pull request as ready for review August 27, 2025 18:17
@gewarren gewarren requested a review from a team as a code owner August 27, 2025 18:17
@gewarren gewarren requested a review from dsplaisted August 27, 2025 18:17
@gewarren gewarren enabled auto-merge (squash) August 27, 2025 19:50
@gewarren gewarren merged commit 93d97dd into main Aug 27, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-48132 branch August 27, 2025 19:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Breaking change]: NuGet packages may not be included in deps.json files if no runtime assets were included from the package
3 participants