docs: Updated project/package descriptions

Author: amis92

src/CodeGeneration.Roslyn.Attributes/CodeGeneration.Roslyn.Attributes.csproj

@@ -3,7 +3,9 @@
   <PropertyGroup>
     <TargetFrameworks>net20;net40;netstandard1.0</TargetFrameworks>
     <RootNamespace>CodeGeneration.Roslyn</RootNamespace>
-    <Description>A package that offers attributes to drive code generation.</Description>
+    <Description>A package that offers attributes to drive code generation. API:
+* CodeGeneration.Roslyn.CodeGenerationAttributeAttribute
+    </Description>
   </PropertyGroup>
 
 </Project>

src/CodeGeneration.Roslyn.Engine/CodeGeneration.Roslyn.Engine.csproj

@@ -2,7 +2,10 @@
 
   <PropertyGroup>
     <TargetFramework>netcoreapp2.0</TargetFramework>
-    <Description>The engine of source code generation used by CodeGeneration.Roslyn.Tool.</Description>
+    <Description>The engine of source code generation; used by CodeGeneration.Roslyn.Tool. Useful for testing custom source generators. API:
+* CodeGeneration.Roslyn.CompilationGenerator
+* CodeGeneration.Roslyn.DocumentTransform
+    </Description>
   </PropertyGroup>
 
   <ItemGroup>

src/CodeGeneration.Roslyn.Plugin.Sdk/CodeGeneration.Roslyn.Plugin.Sdk.csproj

@@ -2,7 +2,12 @@
 
   <PropertyGroup>
     <TargetFramework>netstandard1.0</TargetFramework>
-    <Description>The MSBuild SDK that helps correctly create CodeGeneration.Roslyn plugins.</Description>
+    <Description>The MSBuild project SDK that helps correctly create CodeGeneration.Roslyn plugins (generators).
+
+For the convenience of plugin consumers, create metapackage as well. For details, see project readme: https://github.com/AArnott/CodeGeneration.Roslyn#package-your-code-generator
+
+How to use MSBuild project SDKs: https://docs.microsoft.com/visualstudio/msbuild/how-to-use-project-sdk
+    </Description>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <DevelopmentDependency>true</DevelopmentDependency>
     <SymbolPackageFormat></SymbolPackageFormat>

src/CodeGeneration.Roslyn.PluginMetapackage.Sdk/CodeGeneration.Roslyn.PluginMetapackage.Sdk.csproj

@@ -2,7 +2,12 @@
 
   <PropertyGroup>
     <TargetFramework>netstandard1.0</TargetFramework>
-    <Description>The MSBuild SDK that helps correctly create CodeGeneration.Roslyn plugins.</Description>
+    <Description>The MSBuild project SDK that helps correctly create metapackage for CodeGeneration.Roslyn plugins (generators).
+
+Metapackages are created for the convenience of plugin consumers. For details, see project readme: https://github.com/AArnott/CodeGeneration.Roslyn#package-your-code-generator
+
+How to use MSBuild project SDKs: https://docs.microsoft.com/visualstudio/msbuild/how-to-use-project-sdk
+    </Description>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     <DevelopmentDependency>true</DevelopmentDependency>
     <SymbolPackageFormat></SymbolPackageFormat>

src/CodeGeneration.Roslyn.Tool/CodeGeneration.Roslyn.Tool.csproj

@@ -3,7 +3,7 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <TargetFramework>netcoreapp2.1</TargetFramework>
-    <Description>The dotnet code generation tool that works with the CodeGeneration.Roslyn nuget package.</Description>
+    <Description>Source code generation tool that hosts custom generators (AKA Plugins). This package contains MSBuild targets that run the tool during a build, before compilation. See project site for details.</Description>
     <CodeAnalysisRuleSet>CodeGeneration.Roslyn.Tool.ruleset</CodeAnalysisRuleSet>
     <!-- Run on future runtimes - as a build tool, let's be user friendly. -->
     <RollForward>Major</RollForward>

src/CodeGeneration.Roslyn/CodeGeneration.Roslyn.csproj

@@ -2,7 +2,13 @@
 
   <PropertyGroup>
     <TargetFramework>netstandard2.0</TargetFramework>
-    <Description>A package that offers libraries for creating a code generation attribute and the associated generator.</Description>
+    <Description>Library for creating source generators. API (types contained):
+* CodeGeneration.Roslyn.ICodeGenerator
+* CodeGeneration.Roslyn.IRichCodeGenerator
+* CodeGeneration.Roslyn.Logger
+* CodeGeneration.Roslyn.RichGenerationResult
+* CodeGeneration.Roslyn.TransformationContext
+    </Description>
   </PropertyGroup>
 
   <ItemGroup>