Addressing feedback

Author: Fernando Aguilar

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

@@ -24,35 +24,35 @@ NuGet is unable find the icon file in the package.
 
 - Make sure that the file that is marked as the package icon exists at the source and it is readable, and the target matches the path expected by the `icon` property.
 - Ensure that the file is referenced in the nuspec or in the project file.
-  * When you are creating a package from a nuspec file, make sure to include the icon file in the `<files/>` section:
-
-    ```xml
-    <package>
-        <metadata>
-        <id>sample.lib</id>
-        <version>0.0.1</version>
-        <authors>nuget</authors>
-        <owners>nuget</owners>
-        <license type="expression">MIT</license>
-        <description>Package containing the icon file</description>
-        <icon>icon.jpg</icon>
-        </metadata>
-        <files>
-        <file src="icon.jpg" />
-        </files>
-    </package>
-    ```
-
   * When creating a package from a MSBuild project file, make sure to reference the icon file in the project, as follows:
 
     ```xml
     <Project Sdk="Microsoft.NET.Sdk">
         <PropertyGroup>
-        <TargetFramework>netstandard2.0</TargetFramework>
-        <PackageIcon>icon.jpg</PackageIcon>
+          <TargetFramework>netstandard2.0</TargetFramework>
+          <PackageIcon>icon.jpg</PackageIcon>
         </PropertyGroup>
         <ItemGroup>
-        <None Include="icon.jpg" Pack="true" PackagePath="" />
+          <None Include="icon.jpg" Pack="true" PackagePath="" />
         </ItemGroup>
     </Project>
     ```
+
+  * When you are creating a package from a nuspec file, make sure to include the icon file in the `<files/>` section:
+
+    ```xml
+    <package>
+        <metadata>
+          <id>sample.lib</id>
+          <version>0.0.1</version>
+          <authors>nuget</authors>
+          <owners>nuget</owners>
+          <license type="expression">MIT</license>
+          <description>Package containing the icon file</description>
+          <icon>icon.jpg</icon>
+        </metadata>
+        <files>
+          <file src="icon.jpg" />
+        </files>
+    </package>
+    ```

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

@@ -27,6 +27,20 @@ Icon URL is deprecated in favor of embedding the icon inside the NuGet package.
 
 To stop seeing this warning, add an embedded icon to your package.
 
+For MSBuild project files, add an `<PackageIcon/>` property, as follows:
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <PackageIcon>icon.jpg</PackageIcon>
+  </PropertyGroup>
+  <ItemGroup>
+    <None Include="icon.jpg" Pack="true" PackagePath="" />
+  </ItemGroup>
+</Project>
+```
+
 For nuspec files, add an `<icon/>` entry that points to the file that will be the package icon:
 
 ```xml 
@@ -46,18 +60,4 @@ For nuspec files, add an `<icon/>` entry that points to the file that will be th
 </package>
 ```
 
-For MSBuild project files, add an `<PackageIcon/>` property, as follows:
-
-```xml
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFramework>netstandard2.0</TargetFramework>
-    <PackageIcon>icon.jpg</PackageIcon>
-  </PropertyGroup>
-  <ItemGroup>
-    <None Include="icon.jpg" Pack="true" PackagePath="" />
-  </ItemGroup>
-</Project>
-```
-
 To learn more about embedded icons in NuGet and the Icon URL deprecation efforts, see https://aka.ms/deprecateIconUrl 

docs/reference/msbuild-targets.md

@@ -217,6 +217,7 @@ When packing a license file, you need to use PackageLicenseFile property to spec
     <None Include="licenses\LICENSE.txt" Pack="true" PackagePath=""/>
 </ItemGroup>
 ```
+
 [License file sample](https://github.com/NuGet/Samples/tree/master/PackageLicenseFileExample).
 
 ### Packing an icon image file
@@ -235,8 +236,6 @@ For example:
 </ItemGroup>
 ```
 
-
-
 [Package Icon sample](https://github.com/NuGet/Samples/tree/master/PackageIconExample).
 
 ### IsTool

docs/reference/nuspec.md

@@ -141,7 +141,7 @@ license-expression =  1*1(simple-expression / compound-expression / UNLICENSED)
 #### iconUrl
 
 > [!Important]
-> licenseUrl is being deprecated. Use license instead.
+> iconUrl is being deprecated. Use icon instead.
 
 A URL for a 64x64 image with transparency background to use as the icon for the package in UI display. Be sure this element contains the *direct image URL* and not the URL of a web page containing the image. For example, to use an image from GitHub, use the raw file URL like <em>https://github.com/\<username\>/\<repository\>/raw/\<branch\>/\<logo.png\></em>.