Clarify NU1510 documentation (#3521)

Author: Notheisz57

docs/reference/errors-and-warnings/NU1510.md

@@ -17,68 +17,60 @@ f1_keywords:
 
 ### Issue
 
-The package `System.Text.Json` has been specified for pruning through the [PrunePackageReference](../../consume-packages/Package-References-in-Project-Files.md#prunepackagereference) feature.
-The `.NET SDK` generally specifies the list of packages to be pruned. The package is not needed as a direct PackageReference since the .NET runtime itself carries either the same or higher version of the assembly.
+This warning is raised as a result of NuGet dependency graph pruning, and indicates that an otherwise prunable package was restored due to a direct `PackageReference`.
+The named package can be pruned if the direct `PackageReference` is removed, since the targeted .NET SDK provides the same version or higher of this assembly.
 
-This warning is *only* raised when the PackageReference in question *can be completely removed from the project*.
+This warning only affects packages registered for pruning through the [PrunePackageReference](../../consume-packages/Package-References-in-Project-Files.md#prunepackagereference) feature.
+It is *only* raised when the `PackageReference` in question *can be completely removed from the project*.
 
 #### Example 1
 
+When the targeted .NET SDK includes an equivalent version, *dependency conflict resolution* selects the SDK-bundled assembly:
+
 ```xml
   <PropertyGroup>
+    <!-- 'System.Text.Json' is SDK-bundled in 'net10.0' -->
     <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
+    <!-- The assembly provided by this reference will not be used -->
     <PackageReference Include="System.Text.Json" Version="10.0.0" />
   </ItemGroup>
 ```
 
 #### Example 2
 
-```xml
-  <PropertyGroup>
-    <TargetFrameworks>net9.0;net10.0</TargetFrameworks>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Condition="'$(TargetFramework)' == 'net10.0'" Include="System.Text.Json" Version="10.0.0" />
-    <PackageReference Condition="'$(TargetFramework)' == 'net9.0'" Include="System.Text.Json" Version="9.0.0" />
-  </ItemGroup>
-```
-
-Each conditional `PackageReference` for the `System.Text.Json` package can be removed because the package is already included in the respective .NET runtime versions for the frameworks it is declared for.
-
-#### Example 3
+When the targeted .NET SDK includes an equivalent version for multiple framework targets, *dependency conflict resolution* selects the appropriate SDK-bundled assembly for each target:
 
 ```xml
   <PropertyGroup>
+    <!-- 'System.Text.Json' is SDK-bundled in both TFMs -->
     <TargetFrameworks>net9.0;net10.0</TargetFrameworks>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Condition="'$(TargetFramework)' == 'net9.0'" Include="System.Text.Json" Version="9.0.4" />
+    <!-- Neither of the assemblies provided by these references will be used -->
+    <PackageReference Include="System.Text.Json" Version="10.0.0" Condition="'$(TargetFramework)' == 'net10.0'"/>
+    <PackageReference Include="System.Text.Json" Version="9.0.4" Condition="'$(TargetFramework)' == 'net9.0'"/>
   </ItemGroup>
 ```
 
-The `System.Text.Json` package is within the pruning range of the only framework it's declared for.
-
 ### Solution
 
-Remove the PackageReference as it's unnecessary.
-
-> [!NOTE]
-> In order to allow for easier adoption of the PrunePackageReference feature, this warning is raised by default when a project targets the .NET 10 framework or newer.
+Remove the unnecessary `PackageReference`.
 
 > [!NOTE]
-> The warning will not be raised in scenarios in which at least one of the frameworks still needs the package, such as `net48` in the below example.
+> Beginning with .NET 10, the `PrunePackageReference` feature is enabled by default for all projects that target .NET 10 or higher. The warning is only raised when pruning applies to all runtime targets:
 >
 > ```xml
 >   <PropertyGroup>
+>     <!-- 'System.Text.Json' is not SDK-bundled in 'net48' -->
 >     <TargetFrameworks>net10.0;net48</TargetFrameworks>
 >   </PropertyGroup>
 > 
 >   <ItemGroup>
+>     <!-- This reference is needed in 'net48' - NU1510 is not raised -->
 >     <PackageReference Include="System.Text.Json" Version="9.0.7" />
 >   </ItemGroup>
 > ```