Assembly descriptions take up a lot of space

[MichalStrehovsky]

In an app with a System.CommandLine reference, the following text:

This package includes a powerful command line parser and other tools for building command line applications, including:

    

    * Shell-agnostic support for command line completions

    * Method invocation and an extensible middleware pipeline

    * Constructor- and property-based model binding for complex types

    * Test and debug support

is repeated 28 times, taking up 14+ kB.

The text is embedded in the Win32 resource (UTF-16) and within a custom attribute reference (UTF-8) in each of the System.CommandLine assemblies (the main assembly itself, and 13 satellites assemblies.

My suggestion would be to replace this with a simple "System.CommandLine" string, same as libraries produced in the dotnet/runtime repo do.

[am11]

is repeated 28 times

In spite of our workaround in runtime repo (using <SatelliteResourceLanguages>en-US), is this expected that assembly metadata is not de-duplicated for any given PackageReference?

[KalleOlaviNiemitalo]

Related: dotnet/msbuild#8720 suggesting a warning about overlong AssemblyDescriptionAttribute or Win32 version resource.

Place the long description in PackageDescription, and just a few words in Description. Surely, the description of an assembly should not start with "This package". NuGet pack and restore as MSBuild targets

command-line-api/src/System.CommandLine/System.CommandLine.csproj

Lines 10 to 16 in 87704ce

	<Description>This package includes a powerful command line parser and other tools for building command line applications, including:
	* Shell-agnostic support for command line completions
	* Method invocation and an extensible middleware pipeline
	* Constructor- and property-based model binding for complex types
	* Test and debug support
	</Description>

Besides, "Constructor- and property-based model binding for complex types" in that description seems out of date, as that feature is now in a separate package.

command-line-api/src/System.CommandLine.NamingConventionBinder/System.CommandLine.NamingConventionBinder.csproj

Line 9 in 87704ce

<Description>This package provides command handler support for System.CommandLine performs parameter and model binding by matching option and argument names to parameter and property names.</Description>

[KalleOlaviNiemitalo]

The description of System.CommandLine was shortened in #2224, although one wouldn't guess from the summary of that PR.

command-line-api/src/System.CommandLine/System.CommandLine.csproj

Line 10 in 6b9b8c8

<Description>Support for parsing command lines, supporting both POSIX and Windows conventions and shell-agnostic command line completions.</Description>