User Story 37654: Create Extensions base package

- Fixed .NET runtime installs to actually install just a runtime.
- Misc comment/doc additions and corrections.

Author: paulmedynski

eng/pipelines/dotnet-sqlclient-ci-core.yml

@@ -89,7 +89,7 @@ variables:
 stages:
 
   # Build the Extensions package, and publish it to the pipeline artifacts
-  # under the default name 'Extensions.Artifact'.
+  # under the name specified by the 'extensionsArtifactName' variable.
   - template: stages/ci-build-extensions-package-stage.yml@self
     parameters:
       buildConfiguration: Release

eng/pipelines/stages/ci-build-extensions-package-stage.yml

@@ -207,7 +207,7 @@ stages:
       - task: UseDotNet@2
         displayName: Install .NET 8.0 Runtime
         inputs:
-          packageType: sdk
+          packageType: runtime
           version: 8.x
 
       - task: DotNetCoreCLI@2
@@ -264,7 +264,7 @@ stages:
       - task: UseDotNet@2
         displayName: Install .NET 8.0 Runtime
         inputs:
-          packageType: sdk
+          packageType: runtime
           version: 8.x
 
       - task: DotNetCoreCLI@2

src/Microsoft.Data.SqlClient.Extensions/Extensions/src/Extensions.csproj

@@ -10,7 +10,7 @@
   <PropertyGroup>
     <!--
       We use the ExtensionsPackageVersion from Versions.props.  It may be
-      specified on the command-line, or a default vlaue is used.
+      specified on the command-line, or a default value is used.
     -->
     <PackageVersion>$(ExtensionsPackageVersion)</PackageVersion>
     <!--
@@ -45,9 +45,12 @@
     <RootNamespace>Microsoft.Data.SqlClient.Extensions</RootNamespace>
   </PropertyGroup>
   <ItemGroup>
+    <!-- Our API is CLS Compliant. -->
     <AssemblyAttribute Include="System.CLSCompliantAttribute">
       <_Parameter1>true</_Parameter1>
     </AssemblyAttribute>
+
+    <!-- Our unit tests have access to our internal types. -->
     <InternalsVisibleTo Include="Microsoft.Data.SqlClient.Extensions.Test" />
   </ItemGroup>