Merge main into live

xml/ns-Microsoft.Extensions.AI.Evaluation.Quality.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation.Quality">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains evaluator classes that assess the quality of large language model (LLM) responses in an app according to various metrics.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.Evaluation.Reporting.Formats.Html.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation.Reporting.Formats.Html">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for generating HTML reports that contain evaluation metrics for AI models.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.Evaluation.Reporting.Formats.Json.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation.Reporting.Formats.Json">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for generating JSON reports that contain evaluation metrics for AI models.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.Evaluation.Reporting.Storage.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation.Reporting.Storage">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for storing the results of large language model (LLM) evaluations and for caching LLM responses produced during such evaluations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.Evaluation.Reporting.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation.Reporting">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for generating reports based on AI evaluation metrics and for caching AI model responses.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.Evaluation.xml

@@ -1,6 +1,8 @@
 <Namespace Name="Microsoft.Extensions.AI.Evaluation">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+Contains types and abstractions for evaluating AI-generated responses, including metrics, evaluators, and extensions for interpreting and processing evaluation results.
+</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AI.xml

@@ -1,6 +1,9 @@
 <Namespace Name="Microsoft.Extensions.AI">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>
+      Contains types for building and managing AI-related functionality, including chat clients, embedding generators,
+      tools, and utilities for working with AI services.
+</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AmbientMetadata.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AmbientMetadata">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that represents an application-level metadata model.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.AsyncState.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.AsyncState">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that represents a registered context within the asynchronous state.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Caching.Distributed.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Caching.Distributed">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for distributed caching, including interfaces and implementations for caching serialized values.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Caching.Hybrid.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Caching.Hybrid">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for hybrid caching, combining in-memory and distributed caching strategies.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Caching.Memory.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Caching.Memory">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for in-memory caching, including interfaces and implementations for local caching.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Caching.SqlServer.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Caching.SqlServer">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for distributed caching using Microsoft SQL Server as the backend store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Caching.StackExchangeRedis.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Caching.StackExchangeRedis">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for distributed caching using Redis as the backend store.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Compliance.Classification.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Compliance.Classification">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for data classification, including attributes and utilities for classifying and managing data.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Compliance.Redaction.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Compliance.Redaction">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for redacting sensitive data, including redactors and related utilities.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Compliance.Testing.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Compliance.Testing">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for testing compliance features, including fake redactors and data classifications.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Configuration.EnvironmentVariables.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Configuration.EnvironmentVariables">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for providing configuration key-value pairs from environment variables.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Configuration.KeyPerFile.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Configuration.KeyPerFile">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for using a directory's files as configuration key-value pairs.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.DependencyInjection.Extensions.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.DependencyInjection.Extensions">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains extension methods for adding and removing services in an <c>IServiceCollection</c>.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.DependencyInjection.Pools.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.DependencyInjection.Pools">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and extension methods for configuring and managing object pools in the dependency injection container.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.DependencyModel.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.DependencyModel">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, structs, and interfaces for managing application dependencies, including compile-time and run-time library dependencies.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.DiagnosticAdapter.Infrastructure.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.DiagnosticAdapter.Infrastructure">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains interfaces for creating and managing proxy objects, including factories for run-time proxy creation and unwrappable proxy objects.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Enrichment.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Enrichment">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and interfaces for enriching log records with additional properties, including options and constants for application and process enrichment.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.ExceptionSummarization.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.ExceptionSummarization">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, structs, and interfaces for summarizing exceptions for use in telemetry, including mechanisms to register and implement exception summary providers.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.HealthChecks.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.HealthChecks">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and interfaces for configuring and managing health checks, including options for resource utilization, telemetry, and manual health status control.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Latency.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Latency">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, structs, and interfaces for measuring and exporting latency data, including options for latency contexts, checkpoints, measures, and tags.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Metrics.Configuration.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Metrics.Configuration">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains types for retrieving and managing metrics configuration for specific listener names.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Metrics.Testing.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Metrics.Testing">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for testing metrics, including tools for collecting and working with measurements from instruments.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Metrics.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Metrics">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, interfaces, and enums for configuring, producing, and managing metrics, including support for strongly typed metrics, instrument rules, and listener configurations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Probes.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Probes">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for configuring and managing health-check probes, including options for Kubernetes and TCP-based probes, and standardized health-check tags.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.ResourceMonitoring.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.ResourceMonitoring">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, structs, and interfaces for monitoring system resources, including options for configuration, resource utilization snapshots, and publishers for resource data.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Diagnostics.Sampling.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Diagnostics.Sampling">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes for configuring and managing log sampling, including options and rules for random probabilistic sampling.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.EnumStrings.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.EnumStrings">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that provides information to guide the production of an extension method to efficiently convert an enum value into string form.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileProviders.Composite.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileProviders.Composite">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that represents composite directory contents.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileProviders.Embedded.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileProviders.Embedded">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that represents a file embedded in an assembly.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileProviders.Internal.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileProviders.Internal">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that represents the contents of a physical file directory.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileProviders.Physical.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileProviders.Physical">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides classes and enums for working with the physical file system.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileProviders.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileProviders">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides abstractions and implementations for accessing file systems.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.Abstractions.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing.Abstractions">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains abstractions for file system entities and their wrapper implementations.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.Internal.PathSegments.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing.Internal.PathSegments">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes that support the file system globbing infrastructure. These APIs are not intended for direct use and might change in future releases.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing.Internal.PatternContexts">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and structs that support the file system globbing infrastructure. These APIs are not intended for direct use and might change in future releases.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.Internal.Patterns.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing.Internal.Patterns">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that supports the file system globbing infrastructure. This API is not intended for direct use and might change in future releases.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.Internal.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing.Internal">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, structs, and interfaces that support the file system globbing infrastructure. These APIs are not intended for direct use and might change in future releases.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.FileSystemGlobbing.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.FileSystemGlobbing">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides classes and structs for file-system pattern matching.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Hosting.Testing.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Hosting.Testing">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and interfaces for unit testing a host.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Http.AutoClient.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Http.AutoClient">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes and enums for generating REST APIs and configuring HTTP client requests.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Http.Diagnostics.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Http.Diagnostics">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains classes, interfaces, and enums for managing HTTP diagnostics, including request metadata and redaction strategies.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>

xml/ns-Microsoft.Extensions.Http.Latency.xml

@@ -1,6 +1,6 @@
 <Namespace Name="Microsoft.Extensions.Http.Latency">
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Contains a class that provides options to configure HTTP client latency telemetry.</summary>
     <remarks>To be added.</remarks>
   </Docs>
 </Namespace>