Skip to content

docs: add SdkAnalysisLevel entries for 10.0.300 and 11.0.100#53857

Open
Copilot wants to merge 3 commits into
mainfrom
copilot/update-sdk-analysis-level-documentation
Open

docs: add SdkAnalysisLevel entries for 10.0.300 and 11.0.100#53857
Copilot wants to merge 3 commits into
mainfrom
copilot/update-sdk-analysis-level-documentation

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 14, 2026

Summary

Updates the SdkAnalysisLevel table in docs/core/project-sdk/msbuild-props.md to document the new behaviors gated on SDK analysis level 10.0.300 and 11.0.100, as defined in SdkAnalysisLevelMinimums.cs in the NuGet.Client repo.

Changes

Four new rows added to the SdkAnalysisLevel behavior table:

10.0.300

  • Multi-targeting with duplicate target frameworks via TargetFrameworkAlias — emits NU1018 error when duplicate target frameworks exist without TargetFrameworkAlias set for all frameworks.
  • TargetFrameworkAlias character validation — emits NU1019 error for path separator characters (/ or \), and NU1019 warning for non-ASCII characters.

11.0.100

  • MonoAndroid framework deprecation — emits NU1703 warning when a package uses the deprecated MonoAndroid framework instead of a modern .NET TFM.
  • TargetFrameworkAlias non-ASCII character validation — changes NU1019 from a warning to an error for non-ASCII characters.

Source

Content sourced directly from the NuGet.Client source: SdkAnalysisLevelMinimums.cs, RestoreCommand.cs, MonoAndroidDeprecation.cs, and NuGetLogCode.cs.

Note

This article was updated with the assistance of AI (ai-assisted).


Internal previews

📄 File 🔗 Preview link
docs/core/project-sdk/msbuild-props.md docs/core/project-sdk/msbuild-props

Copilot AI and others added 2 commits May 14, 2026 21:42
Comment thread docs/core/project-sdk/msbuild-props.md Outdated
Comment thread docs/core/project-sdk/msbuild-props.md Outdated
Comment thread docs/core/project-sdk/msbuild-props.md Outdated
Comment thread docs/core/project-sdk/msbuild-props.md Outdated
Co-authored-by: Nikolche Kolev <nikolev@microsoft.com>
Copilot AI review requested due to automatic review settings May 14, 2026 21:52
@nkolev92 nkolev92 marked this pull request as ready for review May 14, 2026 21:52
@nkolev92 nkolev92 requested review from a team and gewarren as code owners May 14, 2026 21:52
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the SdkAnalysisLevel behavior table in docs/core/project-sdk/msbuild-props.md to document NuGet restore behaviors introduced in SDK feature bands 10.0.300 and 11.0.100.

Changes:

  • Add a 10.0.300 table entry for duplicate target framework multi-targeting behavior.
  • Add 10.0.300 and 11.0.100 entries describing NU1019 character validation behavior.
  • Add an 11.0.100 entry describing the MonoAndroid deprecation warning behavior.
Comments suppressed due to low confidence (1)

docs/core/project-sdk/msbuild-props.md:1520

  • These entries attribute NU1019 validation to the TargetFramework property, but the described checks (path separators, non-ASCII) are for TargetFrameworkAlias values used to disambiguate duplicate target frameworks. Please rename the label/text to TargetFrameworkAlias (including the “property contains…” phrasing) so readers don’t think the SDK is validating TargetFramework/TargetFrameworks values.
| 10.0.300         | `TargetFramework` character validation | Emits [NU1019](/nuget/reference/errors-and-warnings/nu1019) error for path separator characters (`/` or `\`) in a `TargetFramework` property, and [NU1019](/nuget/reference/errors-and-warnings/nu1019) warning for non-ASCII characters. |
| 11.0.100         | MonoAndroid framework deprecation warning | Emits [NU1703](/nuget/reference/errors-and-warnings/nu1703) warning when a package uses the deprecated `MonoAndroid` framework instead of a modern .NET target framework moniker. |
| 11.0.100         | `TargetFramework` non-ASCII character validation | Changes [NU1019](/nuget/reference/errors-and-warnings/nu1019) from a warning to an error when a `TargetFramework` property contains non-ASCII characters. |

Comment thread docs/core/project-sdk/msbuild-props.md
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.

4 participants