Document .NET 11 NU1703 warning for deprecated MonoAndroid package assets

docs/core/compatibility/11.md

@@ -90,4 +90,5 @@ See [Breaking changes in EF Core 11](/ef/core/what-is-new/ef-core-11.0/breaking-
 | Title                                                             | Type of change    |
 |-------------------------------------------------------------------|-------------------|
 | [mono launch target not set for .NET Framework apps](sdk/11/mono-launch-target-removed.md) | Behavioral change |
+| [NU1703 warns for packages that use deprecated MonoAndroid framework assets](sdk/11/nu1703-deprecated-monoandroid-framework.md) | Source incompatible |
 | [VSTest removes dependency on Newtonsoft.Json](sdk/11/vstest-removes-newtonsoft-json.md) | Binary/source incompatible |

docs/core/compatibility/sdk/11/nu1703-deprecated-monoandroid-framework.md

@@ -0,0 +1,54 @@
+---
+title: "Breaking change: NU1703 warning for packages that use deprecated MonoAndroid framework assets"
+description: "Learn about the breaking change in .NET 11 where NuGet restore emits NU1703 when a package uses deprecated MonoAndroid framework assets."
+ms.date: 06/01/2026
+ai-usage: ai-assisted
+---
+
+# NU1703 warning for packages that use deprecated MonoAndroid framework assets
+
+NuGet restore now emits NU1703 when an Android project targets .NET 11
+or later and resolves package assets from the deprecated MonoAndroid
+framework folder.
+
+## Version introduced
+
+.NET 11 Preview 5
+
+## Previous behavior
+
+Previously, NuGet restore silently resolved MonoAndroid assets when a package did not provide `net6.0-android` or later assets.
+
+## New behavior
+
+Starting in .NET 11, NuGet restore emits NU1703 when a package resolves
+to deprecated MonoAndroid assets for Android projects that target
+.NET 11 or later and use `SdkAnalysisLevel` `11.0.100` or later.
+
+> Package 'PackageName' 1.0.0 uses the deprecated MonoAndroid framework instead of 'net6.0-android' or later. Consider upgrading to a newer version of this package or contacting the package author.
+
+## Type of breaking change
+
+This change can affect [source compatibility](../../categories.md#source-compatibility).
+
+## Reason for change
+
+To help identify packages that might not work correctly with modern
+Android TFMs, NuGet now warns when restore selects deprecated
+MonoAndroid assets.
+
+For more information, see [NuGet.Client PR #7229](https://github.com/NuGet/NuGet.Client/pull/7229).
+
+## Recommended action
+
+To resolve this warning, update to a package version that provides
+`net6.0-android` or later assets.
+
+If no update exists:
+
+- You can suppress NU1703 for a specific package or for the project.
+- To opt out of this warning wave, you can set `SdkAnalysisLevel` to a value below `11.0.100`.
+
+## Affected APIs
+
+None.

docs/core/compatibility/toc.yml

@@ -66,6 +66,8 @@ items:
             items:
               - name: mono launch target not set for .NET Framework apps
                 href: sdk/11/mono-launch-target-removed.md
+              - name: NU1703 warns for packages that use deprecated MonoAndroid framework assets
+                href: sdk/11/nu1703-deprecated-monoandroid-framework.md
               - name: VSTest removes dependency on Newtonsoft.Json
                 href: sdk/11/vstest-removes-newtonsoft-json.md
       - name: .NET 10