Cleanup XML docs

src/Polly.Extensions/DependencyInjection/AddResiliencePipelineContext.cs

@@ -43,7 +43,7 @@ internal AddResiliencePipelineContext(ConfigureBuilderContext<TKey> registryCont
     /// You can decide based on the <paramref name="name"/> to listen for changes in global options or named options.
     /// If <paramref name="name"/> is <see langword="null"/> then the global options are listened to.
     /// <para>
-    /// You can listen for changes only for single options. If you call this method multiple times, the preceding calls are ignored and only the last one wins.
+    /// You can listen for changes from multiple options by calling this method with different <typeparamref name="TOptions"/> types.
     /// </para>
     /// </remarks>
     public void EnableReloads<[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)] TOptions>(string? name = null)

src/Polly.Extensions/DependencyInjection/PollyServiceCollectionExtensions.cs

@@ -16,15 +16,14 @@ namespace Polly;
 public static class PollyServiceCollectionExtensions
 {
     /// <summary>
-    /// Adds a generic resilience pipeline to service collection.
+    /// Adds a resilience pipeline that handles <typeparamref name="TResult"/> to service collection.
     /// </summary>
     /// <typeparam name="TKey">The type of the key used to identify the resilience pipeline.</typeparam>
     /// <typeparam name="TResult">The type of result that the resilience pipeline handles.</typeparam>
     /// <param name="services">The <see cref="IServiceCollection"/> to add the resilience pipeline to.</param>
     /// <param name="key">The key used to identify the resilience pipeline.</param>
     /// <param name="configure">An action that configures the resilience pipeline.</param>
     /// <returns>The updated <see cref="IServiceCollection"/> with the registered resilience pipeline.</returns>
-    /// <exception cref="InvalidOperationException">Thrown if the resilience pipeline builder with the provided key has already been added to the registry.</exception>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     /// <remarks>
     /// You can retrieve the registered pipeline by resolving the <see cref="ResiliencePipelineProvider{TKey}"/> class from the dependency injection container.
@@ -45,15 +44,14 @@ public static IServiceCollection AddResiliencePipeline<TKey, TResult>(
     }
 
     /// <summary>
-    /// Adds a generic resilience pipeline to service collection.
+    /// Adds a resilience pipeline that handles <typeparamref name="TResult"/> to service collection.
     /// </summary>
     /// <typeparam name="TKey">The type of the key used to identify the resilience pipeline.</typeparam>
     /// <typeparam name="TResult">The type of result that the resilience pipeline handles.</typeparam>
     /// <param name="services">The <see cref="IServiceCollection"/> to add the resilience pipeline to.</param>
     /// <param name="key">The key used to identify the resilience pipeline.</param>
     /// <param name="configure">An action that configures the resilience pipeline.</param>
     /// <returns>The updated <see cref="IServiceCollection"/> with the registered resilience pipeline.</returns>
-    /// <exception cref="InvalidOperationException">Thrown if the resilience pipeline builder with the provided key has already been added to the registry.</exception>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     /// <remarks>
     /// You can retrieve the registered pipeline by resolving the <see cref="ResiliencePipelineProvider{TKey}"/> class from the dependency injection container.
@@ -94,7 +92,6 @@ public static IServiceCollection AddResiliencePipeline<TKey, TResult>(
     /// <param name="key">The key used to identify the resilience pipeline.</param>
     /// <param name="configure">An action that configures the resilience pipeline.</param>
     /// <returns>The updated <see cref="IServiceCollection"/> with the registered resilience pipeline.</returns>
-    /// <exception cref="InvalidOperationException">Thrown if the resilience pipeline builder with the provided key has already been added to the registry.</exception>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     /// <remarks>
     /// You can retrieve the registered pipeline by resolving the <see cref="ResiliencePipelineProvider{TKey}"/> class from the dependency injection container.
@@ -122,7 +119,6 @@ public static IServiceCollection AddResiliencePipeline<TKey>(
     /// <param name="key">The key used to identify the resilience pipeline.</param>
     /// <param name="configure">An action that configures the resilience pipeline.</param>
     /// <returns>The updated <see cref="IServiceCollection"/> with the registered resilience pipeline.</returns>
-    /// <exception cref="InvalidOperationException">Thrown if the resilience pipeline builder with the provided key has already been added to the registry.</exception>
     /// <exception cref="ArgumentNullException">Thrown when <paramref name="services"/> or <paramref name="configure"/> is <see langword="null"/>.</exception>
     /// <remarks>
     /// You can retrieve the registered pipeline by resolving the <see cref="ResiliencePipelineProvider{TKey}"/> class from the dependency injection container.
@@ -157,7 +153,7 @@ public static IServiceCollection AddResiliencePipeline<TKey>(
     }
 
     /// <summary>
-    /// Adds <see cref="ResiliencePipelineRegistry{TKey}"/> and <see cref="ResiliencePipelineProvider{TKey}"/> that allows configuring
+    /// Adds <see cref="ResiliencePipelineRegistry{TKey}"/> and <see cref="ResiliencePipelineProvider{TKey}"/> to service collection that allows configuring
     /// and retrieving resilience pipelines using the <typeparamref name="TKey"/> key.
     /// </summary>
     /// <typeparam name="TKey">The type of the key used to identify the resilience pipeline.</typeparam>
@@ -183,7 +179,7 @@ public static IServiceCollection AddResiliencePipelineRegistry<TKey>(
     }
 
     /// <summary>
-    /// Adds <see cref="ResiliencePipelineRegistry{TKey}"/> and <see cref="ResiliencePipelineProvider{TKey}"/> that allows configuring
+    /// Adds <see cref="ResiliencePipelineRegistry{TKey}"/> and <see cref="ResiliencePipelineProvider{TKey}"/> to service collection that allows configuring
     /// and retrieving resilience pipelines using the <typeparamref name="TKey"/> key.
     /// </summary>
     /// <typeparam name="TKey">The type of the key used to identify the resilience pipeline.</typeparam>

src/Polly.Extensions/Registry/ConfigureBuilderContextExtensions.cs

@@ -22,7 +22,7 @@ public static class ConfigureBuilderContextExtensions
     /// You can decide based on the <paramref name="name"/> to listen for changes in global options or named options.
     /// If <paramref name="name"/> is <see langword="null"/> then the global options are listened to.
     /// <para>
-    /// You can listen for changes only for single options. If you call this method multiple times, the preceding calls are ignored and only the last one wins.
+    /// You can listen for changes from multiple options by calling this method with different <typeparamref name="TOptions"/> types.
     /// </para>
     /// </remarks>
     public static void EnableReloads<TKey, [DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)] TOptions>(