From 1a2b420e3fe0c18792ac086ddb0f872ffce5e0bb Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Fri, 3 Oct 2025 11:14:23 -0700
Subject: [PATCH] small doc fixes

---
 .../Contents/McpServerToolCallContent.cs                    | 2 +-
 .../Tools/HostedMcpServerTool.cs                            | 4 ++--
 .../CSharp/IEvaluationReportWriter.cs                       | 2 +-
 .../ApplicationMetadataConfigurationBuilderExtensions.cs    | 4 ++--
 .../ApplicationMetadataServiceCollectionExtensions.cs       | 2 +-
 .../Microsoft.Extensions.AsyncState/IAsyncContext.cs        | 2 +-
 .../Microsoft.Extensions.AsyncState/IAsyncLocalContext.cs   | 2 +-
 .../Microsoft.Extensions.AsyncState/IAsyncState.cs          | 2 +-
 .../FakeRedactionServiceCollectionExtensions.cs             | 6 +++---
 9 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/src/Libraries/Microsoft.Extensions.AI.Abstractions/Contents/McpServerToolCallContent.cs b/src/Libraries/Microsoft.Extensions.AI.Abstractions/Contents/McpServerToolCallContent.cs
index 5ed6385789c..ec7f993a25f 100644
--- a/src/Libraries/Microsoft.Extensions.AI.Abstractions/Contents/McpServerToolCallContent.cs
+++ b/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)
     {
diff --git a/src/Libraries/Microsoft.Extensions.AI.Abstractions/Tools/HostedMcpServerTool.cs b/src/Libraries/Microsoft.Extensions.AI.Abstractions/Tools/HostedMcpServerTool.cs
index b5ed4938a45..26fc3cd6434 100644
--- a/src/Libraries/Microsoft.Extensions.AI.Abstractions/Tools/HostedMcpServerTool.cs
+++ b/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)
     {
diff --git a/src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/IEvaluationReportWriter.cs b/src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/IEvaluationReportWriter.cs
index 97c1fdca15e..70b6492a17c 100644
--- a/src/Libraries/Microsoft.Extensions.AI.Evaluation.Reporting/CSharp/IEvaluationReportWriter.cs
+++ b/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(
diff --git a/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataConfigurationBuilderExtensions.cs b/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataConfigurationBuilderExtensions.cs
index 4dfacb812de..c3b303a5a0e 100644
--- a/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataConfigurationBuilderExtensions.cs
+++ b/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)
diff --git a/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataServiceCollectionExtensions.cs b/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataServiceCollectionExtensions.cs
index bc08c2a60e9..1e84e50c4f1 100644
--- a/src/Libraries/Microsoft.Extensions.AmbientMetadata.Application/ApplicationMetadataServiceCollectionExtensions.cs
+++ b/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)
     {
diff --git a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncContext.cs b/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncContext.cs
index 478faa315ea..f10827b1954 100644
--- a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncContext.cs
+++ b/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>
diff --git a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncLocalContext.cs b/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncLocalContext.cs
index 9873375a78b..ed33f8afeb2 100644
--- a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncLocalContext.cs
+++ b/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>
diff --git a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncState.cs b/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncState.cs
index 2593136a736..4bf4c748146 100644
--- a/src/Libraries/Microsoft.Extensions.AsyncState/IAsyncState.cs
+++ b/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
 {
diff --git a/src/Libraries/Microsoft.Extensions.Compliance.Testing/FakeRedactionServiceCollectionExtensions.cs b/src/Libraries/Microsoft.Extensions.Compliance.Testing/FakeRedactionServiceCollectionExtensions.cs
index eab81632049..43637a7d726 100644
--- a/src/Libraries/Microsoft.Extensions.Compliance.Testing/FakeRedactionServiceCollectionExtensions.cs
+++ b/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);