Skip to content

Add breaking change documentation for PackageReference version requirement #46922

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 24, 2025

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jun 23, 2025

This PR adds documentation for the breaking change where PackageReference without a version will raise an NU1015 error instead of an NU1604 warning in .NET 10 Preview 6.

Changes made

  • Created new breaking change document: docs/core/compatibility/sdk/10.0/nu1015-packagereference-version.md

    • Follows the established breaking change template
    • Documents the change from NU1604 warning to NU1015 error
    • Includes clear before/after code examples
    • Provides recommended actions with version specification examples
    • Explains the workaround using SdkAnalysisLevel
  • Updated TOC: Added entry to docs/core/compatibility/toc.yml under SDK and MSBuild section for .NET 10

  • Updated index: Added entry to docs/core/compatibility/10.0.md under SDK and MSBuild section with correct categorization as "Behavioral change" and "Preview 6" version

Key details covered

  • Previous behavior: NuGet raised NU1604 warning about missing lower bound
  • New behavior: NuGet raises NU1015 error about missing version specification
  • Reason: The previous "no lower bound" message was confusing and unclear
  • Impact: No change for Central Package Management scenarios
  • Workaround: Set SdkAnalysisLevel to 9.0.300 or lower to revert to previous behavior

The documentation is positioned alphabetically in both the TOC and index files, maintaining consistency with existing structure.

Fixes #46386.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


Internal previews

📄 File 🔗 Preview link
docs/core/compatibility/10.0.md Breaking changes in .NET 10
docs/core/compatibility/sdk/10.0/nu1015-packagereference-version.md PackageReference without a version will raise an error
docs/core/compatibility/toc.yml docs/core/compatibility/toc

…ement

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] [Breaking change]: PackageReference without a version will raise an error Add breaking change documentation for PackageReference version requirement Jun 23, 2025
@Copilot Copilot AI requested a review from gewarren June 23, 2025 13:34
Copilot finished work on behalf of gewarren June 23, 2025 13:34
@gewarren gewarren requested a review from zivkan June 23, 2025 13:57
Copy link
Member

@zivkan zivkan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @gewarren

@gewarren gewarren marked this pull request as ready for review June 24, 2025 05:40
@gewarren gewarren requested a review from a team as a code owner June 24, 2025 05:40
@gewarren gewarren merged commit b3a3605 into main Jun 24, 2025
10 checks passed
@gewarren gewarren deleted the copilot/fix-46386 branch June 24, 2025 05:40
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]: PackageReference without a version will raise an error
3 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy