small doc fixes (#6887)

Author: gewarren

src/Libraries/Microsoft.Extensions.AI.Abstractions/Contents/McpServerToolCallContent.cs

@@ -24,7 +24,7 @@ public sealed class McpServerToolCallContent : AIContent
     /// <param name="callId">The tool call ID.</param>
     /// <param name="toolName">The tool name.</param>
     /// <param name="serverName">The MCP server name.</param>
-    /// <exception cref="ArgumentNullException"><paramref name="callId"/>, <paramref name="toolName"/>, or <paramref name="serverName"/> are <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentNullException"><paramref name="callId"/>, <paramref name="toolName"/>, or <paramref name="serverName"/> is <see langword="null"/>.</exception>
     /// <exception cref="ArgumentException"><paramref name="callId"/>, <paramref name="toolName"/>, or <paramref name="serverName"/> are empty or composed entirely of whitespace.</exception>
     public McpServerToolCallContent(string callId, string toolName, string serverName)
     {

src/Libraries/Microsoft.Extensions.AI.Abstractions/Tools/HostedMcpServerTool.cs

@@ -19,7 +19,7 @@ public class HostedMcpServerTool : AITool
     /// </summary>
     /// <param name="serverName">The name of the remote MCP server.</param>
     /// <param name="url">The URL of the remote MCP server.</param>
-    /// <exception cref="ArgumentNullException"><paramref name="serverName"/> or <paramref name="url"/> are <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentNullException"><paramref name="serverName"/> or <paramref name="url"/> is <see langword="null"/>.</exception>
     /// <exception cref="ArgumentException"><paramref name="serverName"/> is empty or composed entirely of whitespace.</exception>
     public HostedMcpServerTool(string serverName, [StringSyntax(StringSyntaxAttribute.Uri)] string url)
         : this(serverName, new Uri(Throw.IfNull(url)))
@@ -31,7 +31,7 @@ public HostedMcpServerTool(string serverName, [StringSyntax(StringSyntaxAttribut
     /// </summary>
     /// <param name="serverName">The name of the remote MCP server.</param>
     /// <param name="url">The URL of the remote MCP server.</param>
-    /// <exception cref="ArgumentNullException"><paramref name="serverName"/> or <paramref name="url"/> are <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentNullException"><paramref name="serverName"/> or <paramref name="url"/> is <see langword="null"/>.</exception>
     /// <exception cref="ArgumentException"><paramref name="serverName"/> is empty or composed entirely of whitespace.</exception>
     public HostedMcpServerTool(string serverName, Uri url)
     {

src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/IEvaluationReportWriter.cs

@@ -17,7 +17,7 @@ public interface IEvaluationReportWriter
     /// Writes a report containing all the <see cref="EvaluationMetric"/>s present in the supplied
     /// <paramref name="scenarioRunResults"/>s.
     /// </summary>
-    /// <param name="scenarioRunResults">An enumeration of <see cref="ScenarioRunResult"/>s.</param>
+    /// <param name="scenarioRunResults">A collection of run results from which to generate the report.</param>
     /// <param name="cancellationToken">A <see cref="CancellationToken"/> that can cancel the operation.</param>
     /// <returns>A <see cref="ValueTask"/> that represents the asynchronous operation.</returns>
     ValueTask WriteReportAsync(

src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataConfigurationBuilderExtensions.cs

@@ -20,8 +20,8 @@ public static class ApplicationMetadataConfigurationBuilderExtensions
     /// </summary>
     /// <param name="builder">The configuration builder.</param>
     /// <param name="hostEnvironment">An instance of <see cref="IHostEnvironment" />.</param>
-    /// <param name="sectionName">Section name to save configuration into. Default set to "ambientmetadata:application".</param>
-    /// <returns>The value of <paramref name="builder"/>>.</returns>
+    /// <param name="sectionName">The section name to save configuration into. The default is "ambientmetadata:application".</param>
+    /// <returns>The value of <paramref name="builder"/>.</returns>
     /// <exception cref="ArgumentNullException"><paramref name="builder"/> or <paramref name="hostEnvironment"/> is <see langword="null"/>.</exception>
     /// <exception cref="ArgumentException"><paramref name="sectionName"/> is either <see langword="null"/>, empty, or whitespace.</exception>
     public static IConfigurationBuilder AddApplicationMetadata(this IConfigurationBuilder builder, IHostEnvironment hostEnvironment, string sectionName = DefaultSectionName)

src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataServiceCollectionExtensions.cs

@@ -35,7 +35,7 @@ public static IServiceCollection AddApplicationMetadata(this IServiceCollection
     /// </summary>
     /// <param name="services">The dependency injection container to add the instance to.</param>
     /// <param name="configure">The delegate to configure <see cref="ApplicationMetadata"/> with.</param>
-    /// <returns>The value of <paramref name="services"/>>.</returns>
+    /// <returns>The value of <paramref name="services"/>.</returns>
     /// <exception cref="ArgumentNullException"><paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     public static IServiceCollection AddApplicationMetadata(this IServiceCollection services, Action<ApplicationMetadata> configure)
     {

src/Libraries/Microsoft.Extensions.AsyncState/IAsyncContext.cs

@@ -8,7 +8,7 @@ namespace Microsoft.Extensions.AsyncState;
 
 /// <summary>
 /// Provides access to the current async context.
-/// Some implementations of this interface may not be thread safe.
+/// Some implementations of this interface might not be thread safe.
 /// </summary>
 /// <typeparam name="T">The type of the asynchronous state.</typeparam>
 public interface IAsyncContext<T>

src/Libraries/Microsoft.Extensions.AsyncState/IAsyncLocalContext.cs

@@ -7,7 +7,7 @@ namespace Microsoft.Extensions.AsyncState;
 
 /// <summary>
 /// Provides access to the current async context stored outside of the HTTP pipeline.
-/// Some implementations of this interface may not be thread safe.
+/// Some implementations of this interface might not be thread safe.
 /// </summary>
 /// <typeparam name="T">The type of the asynchronous state.</typeparam>
 /// <remarks>This type is intended for internal use. Use <see cref="IAsyncContext{T}"/> instead.</remarks>

src/Libraries/Microsoft.Extensions.AsyncState/IAsyncState.cs

@@ -9,7 +9,7 @@ namespace Microsoft.Extensions.AsyncState;
 
 /// <summary>
 /// Encapsulates all information within the asynchronous flow in an <see cref="AsyncLocal{T}"/> variable.
-/// Some implementations of this interface may not be thread safe.
+/// Some implementations of this interface might not be thread safe.
 /// </summary>
 public interface IAsyncState
 {

src/Libraries/Microsoft.Extensions.Compliance.Testing/FakeRedactionServiceCollectionExtensions.cs

@@ -18,7 +18,7 @@ public static class FakeRedactionServiceCollectionExtensions
     /// <summary>
     /// Registers the fake redactor provider that always returns fake redactor instances.
     /// </summary>
-    /// <param name="services">Container used to register fake redaction classes.</param>
+    /// <param name="services">The container used to register fake redaction classes.</param>
     /// <returns>The value of <paramref name="services" />.</returns>
     /// <exception cref="ArgumentNullException"><paramref name="services"/> is <see langword="null"/>.</exception>
     public static IServiceCollection AddFakeRedaction(this IServiceCollection services)
@@ -42,10 +42,10 @@ public static IServiceCollection AddFakeRedaction(this IServiceCollection servic
     /// <summary>
     /// Registers the fake redactor provider that always returns fake redactor instances.
     /// </summary>
-    /// <param name="services">Container used to register fake redaction classes.</param>
+    /// <param name="services">The container used to register fake redaction classes.</param>
     /// <param name="configure">Configures fake redactor.</param>
     /// <returns>The value of <paramref name="services" />.</returns>
-    /// <exception cref="ArgumentNullException"><paramref name="services"/> or <paramref name="configure"/>> are <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentNullException"><paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     public static IServiceCollection AddFakeRedaction(this IServiceCollection services, Action<FakeRedactorOptions> configure)
     {
         _ = Throw.IfNull(services);