Package descriptions for CSharp and VB should include summary blurb (#22166)

633f8b2f · Julien Couvreur · GitHub · f827f7a8 · 633f8b2f · 633f8b2f
32 changed file
--- a/src/NuGet/Microsoft.CodeAnalysis.Build.Tasks.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Build.Tasks.nuspec
@@ -2,12 +2,16 @@
 <package>
 <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis.Build.Tasks</id>
-    <summary>The build Tasks for running the C# and VB compilers in MSBuild.</summary>
+    <summary>
+      The build task and targets used by MSBuild to run the C# and VB compilers.
+    </summary>
    <description>
-        Contains the build task and targets used by MSBuild to run the C# and VB compilers.
-        Supports using VBCSCompiler on Windows.
+      The build task and targets used by MSBuild to run the C# and VB compilers.
+      Supports using VBCSCompiler on Windows.

-        $commitPathMessage$
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
    </description>
    <dependencies>
      <group targetFramework="netstandard1.3">

--- a/src/NuGet/Microsoft.CodeAnalysis.CSharp.CodeStyle.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.CSharp.CodeStyle.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") code style analyzers for C#.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") code style analyzers for C#.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
    </dependencies>


--- a/src/NuGet/Microsoft.CodeAnalysis.CSharp.Features.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.CSharp.Features.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") support for creating C# editing experiences.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for creating C# editing experiences.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Features" version="$version$" />
      <dependency id="Microsoft.CodeAnalysis.CSharp.Workspaces" version="$version$" />

--- a/src/NuGet/Microsoft.CodeAnalysis.CSharp.Scripting.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.CSharp.Scripting.nuspec
@@ -2,8 +2,16 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>Microsoft.CodeAnalysis.CSharp.Scripting</id>
-    <summary>Microsoft .NET Compiler Platform ("Roslyn") CSharp scripting package.</summary>
-    <description>$commitPathMessage$</description>
+    <summary>
+      Microsoft .NET Compiler Platform ("Roslyn") CSharp scripting package.
+    </summary>
+    <description>
+      Microsoft .NET Compiler Platform ("Roslyn") CSharp scripting package.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.CodeAnalysis.CSharp.Workspaces.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.CSharp.Workspaces.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") support for analyzing C# projects and solutions.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for analyzing C# projects and solutions.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.CSharp" version="[$version$]" />
      <dependency id="Microsoft.CodeAnalysis.Workspaces.Common" version="[$version$]" />

--- a/src/NuGet/Microsoft.CodeAnalysis.CSharp.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.CSharp.nuspec
@@ -4,10 +4,14 @@
    <id>Microsoft.CodeAnalysis.CSharp</id>
    <summary>
      .NET Compiler Platform ("Roslyn") support for C#, Microsoft.CodeAnalysis.CSharp.dll.
+    </summary>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for C#, Microsoft.CodeAnalysis.CSharp.dll.

      More details at https://aka.ms/roslyn-packages
-    </summary>
-    <description>$commitPathMessage$</description>
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Common" version="[$version$]" />
    </dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.Common.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Common.nuspec
@@ -2,9 +2,14 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis.Common</id>
-    <summary>A shared package used by the Microsoft .NET Compiler Platform ("Roslyn").</summary>
+    <summary>
+      A shared package used by the Microsoft .NET Compiler Platform ("Roslyn").
+    </summary>
    <description>
-      A shared package used by the Microsoft .NET Compiler Platform ("Roslyn"). Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      A shared package used by the Microsoft .NET Compiler Platform ("Roslyn").
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      More details at https://aka.ms/roslyn-packages

      $commitPathMessage$
    </description>

--- a/src/NuGet/Microsoft.CodeAnalysis.Compilers.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Compilers.nuspec
@@ -2,9 +2,13 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis.Compilers</id>
-    <summary>.NET Compiler Platform ("Roslyn")</summary>
+    <summary>
+      Compiler layer of the .NET Compiler Platform ("Roslyn").
+    </summary>
    <description>
-      .NET Compiler Platform ("Roslyn"). Install this package to get both C# and Visual Basic support. Install either of the dependencies directly to get one of the languages separately.
+      Compiler layer of the .NET Compiler Platform ("Roslyn").
+      Install this package to get both C# and Visual Basic support.
+      If you want just support for one language, install Microsoft.CodeAnalysis.CSharp or Microsoft.CodeAnalysis.VisualBasic.

      More details at https://aka.ms/roslyn-packages


--- a/src/NuGet/Microsoft.CodeAnalysis.Debugging.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Debugging.nuspec
@@ -2,9 +2,15 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis.Debugging</id>
-    <summary>Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") debug information encoders and decoders</summary>
+    <summary>
+      Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") debug information encoders and decoders.
+    </summary>
    <description>
      Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") debug information encoders and decoders.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>

--- a/src/NuGet/Microsoft.CodeAnalysis.EditorFeatures.Text.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.EditorFeatures.Text.nuspec
@@ -6,9 +6,13 @@
      .NET Compiler Platform ("Roslyn") support for working with Visual Studio text buffers.
    </summary>
    <description>
+      .NET Compiler Platform ("Roslyn") support for working with Visual Studio text buffers.
+
      Supported Platforms:
      - .NET Framework 4.6

+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>
    <dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.EditorFeatures.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.EditorFeatures.nuspec
@@ -3,12 +3,16 @@
  <metadata>
    <id>Microsoft.CodeAnalysis.EditorFeatures</id>
    <summary>
-      .NET Compiler Platform ("Roslyn") support for editor features inside the Visual Studio editor..
+      .NET Compiler Platform ("Roslyn") support for editor features inside the Visual Studio editor.
    </summary>
    <description>
+      .NET Compiler Platform ("Roslyn") support for editor features inside the Visual Studio editor.
+
      Supported Platforms:
      - .NET Framework 4.6
      
+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>
    <dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.Features.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Features.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") support for creating editing experiences.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for creating editing experiences.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Workspaces.Common" version="$version$" />
    </dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.PooledObjects.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.PooledObjects.nuspec
@@ -2,9 +2,15 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis.PooledObjects</id>
-    <summary>Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") pooled objects</summary>
+    <summary>
+      Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") pooled objects.
+    </summary>
    <description>
      Package containing sources of Microsoft .NET Compiler Platform ("Roslyn") pooled objects.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>

--- a/src/NuGet/Microsoft.CodeAnalysis.Remote.Razor.ServiceHub.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Remote.Razor.ServiceHub.nuspec
@@ -6,12 +6,15 @@
      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
    </summary>
    <description>
-      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process. Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      Supported Platforms:
+      - .NET Framework 4.6

-Supported Platforms:
- .NET Framework 4.6
+      More details at https://aka.ms/roslyn-packages

-    $commitPathMessage$
+      $commitPathMessage$
    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Remote.Workspaces" version="[$version$]" />

--- a/src/NuGet/Microsoft.CodeAnalysis.Remote.ServiceHub.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Remote.ServiceHub.nuspec
@@ -6,12 +6,15 @@
      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
    </summary>
    <description>
-      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process. Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      Supported Platforms:
+      - .NET Framework 4.6

-Supported Platforms:
- .NET Framework 4.6
+      More details at https://aka.ms/roslyn-packages

-    $commitPathMessage$
+      $commitPathMessage$
    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Remote.Workspaces" version="[$version$]" />

--- a/src/NuGet/Microsoft.CodeAnalysis.Remote.Workspaces.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Remote.Workspaces.nuspec
@@ -6,12 +6,15 @@
      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
    </summary>
    <description>
-      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process. Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      A shared package used by the .NET Compiler Platform ("Roslyn") including support for coordinating analysis of projects and solutions using a separate server process.
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      Supported Platforms:
+      - .NET Framework 4.6

-Supported Platforms:
- .NET Framework 4.6
+      More details at https://aka.ms/roslyn-packages

-    $commitPathMessage$
+      $commitPathMessage$
    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Common" version="[$version$]" />

--- a/src/NuGet/Microsoft.CodeAnalysis.Scripting.Common.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Scripting.Common.nuspec
@@ -2,9 +2,14 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>Microsoft.CodeAnalysis.Scripting.Common</id>
-    <summary>Microsoft .NET Compiler Platform ("Roslyn") shared scripting package.</summary>
+    <summary>
+      Microsoft .NET Compiler Platform ("Roslyn") shared scripting package.
+    </summary>
    <description>
-      Microsoft .NET Compiler Platform ("Roslyn") shared scripting package. Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      Microsoft .NET Compiler Platform ("Roslyn") shared scripting package.
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      More details at https://aka.ms/roslyn-packages

      $commitPathMessage$
    </description>

--- a/src/NuGet/Microsoft.CodeAnalysis.Scripting.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Scripting.nuspec
@@ -2,10 +2,14 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>Microsoft.CodeAnalysis.Scripting</id>
-    <summary>Microsoft .NET Compiler Platform ("Roslyn") CSharp and VB scripting package.</summary>
+    <summary>
+      Microsoft .NET Compiler Platform ("Roslyn") CSharp and VB scripting package.
+    </summary>
    <description>
      Microsoft .NET Compiler Platform ("Roslyn") CSharp and VB scripting package.

+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>
    <dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.CodeStyle.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.CodeStyle.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") code style analyzers for Visual Basic.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") code style analyzers for Visual Basic.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
    </dependencies>


--- a/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Features.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Features.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") support for creating Visual Basic editing experiences.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for creating Visual Basic editing experiences.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Features" version="$version$" />
      <dependency id="Microsoft.CodeAnalysis.VisualBasic.Workspaces" version="$version$" />

--- a/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Scripting.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Scripting.nuspec
@@ -2,10 +2,14 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>Microsoft.CodeAnalysis.VisualBasic.Scripting</id>
-    <summary>Microsoft .NET Compiler Platform ("Roslyn") Visual Basic scripting package.</summary>
+    <summary>
+      Microsoft .NET Compiler Platform ("Roslyn") Visual Basic scripting package.
+    </summary>
    <description>
      Microsoft .NET Compiler Platform ("Roslyn") Visual Basic scripting package.
      
+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>


--- a/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Workspaces.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.Workspaces.nuspec
@@ -5,7 +5,13 @@
    <summary>
      .NET Compiler Platform ("Roslyn") support for analyzing Visual Basic projects and solutions.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for analyzing Visual Basic projects and solutions.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.VisualBasic" version="[$version$]" />
      <dependency id="Microsoft.CodeAnalysis.Workspaces.Common" version="[$version$]" />

--- a/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.VisualBasic.nuspec
@@ -4,10 +4,14 @@
    <id>Microsoft.CodeAnalysis.VisualBasic</id>
    <summary>
      .NET Compiler Platform ("Roslyn") support for Visual Basic, Microsoft.CodeAnalysis.VisualBasic.dll.
+    </summary>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for Visual Basic, Microsoft.CodeAnalysis.VisualBasic.dll.

      More details at https://aka.ms/roslyn-packages
-    </summary>
-    <description>$commitPathMessage$</description>
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis.Common" version="$version$" />
    </dependencies>

--- a/src/NuGet/Microsoft.CodeAnalysis.Workspaces.Common.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.Workspaces.Common.nuspec
@@ -6,7 +6,10 @@
      A shared package used by the .NET Compiler Platform ("Roslyn") including support for analyzing projects and solutions.
    </summary>
    <description>
-      A shared package used by the .NET Compiler Platform ("Roslyn") including support for analyzing projects and solutions. Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+      A shared package used by the .NET Compiler Platform ("Roslyn") including support for analyzing projects and solutions.
+      Do not install this package manually, it will be added as a prerequisite by other packages that require it.
+
+      More details at https://aka.ms/roslyn-packages

      $commitPathMessage$
    </description>

--- a/src/NuGet/Microsoft.CodeAnalysis.nuspec
+++ b/src/NuGet/Microsoft.CodeAnalysis.nuspec
@@ -2,7 +2,9 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata minClientVersion="3.3">
    <id>Microsoft.CodeAnalysis</id>
-    <summary>.NET Compiler Platform ("Roslyn").</summary>
+    <summary>
+      .NET Compiler Platform ("Roslyn").
+    </summary>
    <description>
      .NET Compiler Platform ("Roslyn").

@@ -13,6 +15,8 @@
        - "Microsoft.CodeAnalysis.CSharp" (only the C# compiler)      
        - "Microsoft.CodeAnalysis.VisualBasic (only the VB compiler)

+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>
    <dependencies>

--- a/src/NuGet/Microsoft.NETCore.Compilers.nuspec
+++ b/src/NuGet/Microsoft.NETCore.Compilers.nuspec
@@ -5,7 +5,13 @@
    <summary>
      CoreCLR-compatible versions of the C# and VB compilers for use in MSBuild.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      CoreCLR-compatible versions of the C# and VB compilers for use in MSBuild.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.Net.CSharp.Interactive.netcore.nuspec
+++ b/src/NuGet/Microsoft.Net.CSharp.Interactive.netcore.nuspec
@@ -4,11 +4,17 @@
    <id>Microsoft.Net.CSharp.Interactive.netcore</id>
    <summary>
      CoreCLR-compatible version of csi.exe.
+    </summary>
+    <description>
+      CoreCLR-compatible version of csi.exe.

      Supported Platforms:
      - .NET Core (NETCoreApp1.0)
-    </summary>
-    <description>$commitPathMessage$</description>
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.Net.Compilers.netcore.nuspec
+++ b/src/NuGet/Microsoft.Net.Compilers.netcore.nuspec
@@ -5,7 +5,13 @@
    <summary>
      CoreCLR-compatible versions of the C# and VB compilers.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      CoreCLR-compatible versions of the C# and VB compilers.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.Net.Compilers.nuspec
+++ b/src/NuGet/Microsoft.Net.Compilers.nuspec
@@ -3,11 +3,18 @@
  <metadata>
    <id>Microsoft.Net.Compilers</id>
    <summary>
-    .Net Compilers package. Referencing this package will cause the project to be built using the specific version of the C# and Visual Basic compilers contained in the package, as opposed to any system installed version.
-
-    This package can be used to compile code targeting any platform, but can only be run using the desktop .NET 4.6+ Full Framework.
+      .NET Compilers package.
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compilers package.
+      Referencing this package will cause the project to be built using the specific version of the C# and Visual Basic compilers contained in the package, as opposed to any system installed version.
+
+      This package can be used to compile code targeting any platform, but can only be run using the desktop .NET 4.6+ Full Framework.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.VisualStudio.IntegrationTest.Utilities.nuspec
+++ b/src/NuGet/Microsoft.VisualStudio.IntegrationTest.Utilities.nuspec
@@ -2,8 +2,16 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>Microsoft.VisualStudio.IntegrationTest.Utilities</id>
-    <summary>Utility methods used to run Visual Studio integration tests.</summary>
-    <description>$commitPathMessage$</description>
+    <summary>
+      Utility methods used to run Visual Studio integration tests.
+    </summary>
+    <description>
+      Utility methods used to run Visual Studio integration tests.
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <language>en-US</language>
    <requireLicenseAcceptance>true</requireLicenseAcceptance>
    <version>$version$</version>

--- a/src/NuGet/Microsoft.VisualStudio.LanguageServices.Razor.RemoteClient.nuspec
+++ b/src/NuGet/Microsoft.VisualStudio.LanguageServices.Razor.RemoteClient.nuspec
@@ -6,9 +6,13 @@
      .NET Compiler Platform ("Roslyn") support for Visual Studio "15".
    </summary>
    <description>
+      .NET Compiler Platform ("Roslyn") support for Visual Studio "15".
+
      Supported Platforms:
        - .NET Framework 4.6

+      More details at https://aka.ms/roslyn-packages
+
      $commitPathMessage$
    </description>
    <dependencies>

--- a/src/NuGet/Microsoft.VisualStudio.LanguageServices.nuspec
+++ b/src/NuGet/Microsoft.VisualStudio.LanguageServices.nuspec
@@ -4,11 +4,17 @@
    <id>Microsoft.VisualStudio.LanguageServices</id>
    <summary>
      .NET Compiler Platform ("Roslyn") support for Visual Studio.
-      
-Supported Platforms:
- .NET Framework 4.6
    </summary>
-    <description>$commitPathMessage$</description>
+    <description>
+      .NET Compiler Platform ("Roslyn") support for Visual Studio.
+      
+      Supported Platforms:
+      - .NET Framework 4.6
+
+      More details at https://aka.ms/roslyn-packages
+
+      $commitPathMessage$
+    </description>
    <dependencies>
      <dependency id="Microsoft.CodeAnalysis" version="[$version$]" />
    </dependencies>