From 594a9fc5dc2a2518963d1eadfe137711eff11763 Mon Sep 17 00:00:00 2001
From: Maledong <maledong_public@foxmail.com>
Date: Fri, 13 Aug 2021 09:13:42 +0800
Subject: [PATCH 1/4] docs: add missing xml document's comments

add missing xml document's comments
---
 .../src/ConfigurationExtensions.cs                          | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
index 0618e9b018e417..89e8ae6ae59f55 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
@@ -28,7 +28,7 @@ public static class ConfigurationExtensions
         /// <summary>
         /// Shorthand for GetSection("ConnectionStrings")[name].
         /// </summary>
-        /// <param name="configuration">The configuration.</param>
+        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
         /// <param name="name">The connection string key.</param>
         /// <returns>The connection string.</returns>
         public static string GetConnectionString(this IConfiguration configuration, string name)
@@ -73,6 +73,8 @@ public static IEnumerable<KeyValuePair<string, string>> AsEnumerable(this IConfi
         /// <summary>
         /// Determines whether the section has a <see cref="IConfigurationSection.Value"/> or has children
         /// </summary>
+        /// <param name="section">The <see cref="IConfigurationSection"/> to enumerate.</param>
+        /// <returns>A flag to indicate whether the section has values or not.</returns>
         public static bool Exists(this IConfigurationSection section)
         {
             if (section == null)
@@ -85,7 +87,7 @@ public static bool Exists(this IConfigurationSection section)
         /// <summary>
         /// Gets a configuration sub-section with the specified key.
         /// </summary>
-        /// <param name="configuration"></param>
+        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
         /// <param name="key">The key of the configuration section.</param>
         /// <returns>The <see cref="IConfigurationSection"/>.</returns>
         /// <remarks>

From b703d4746a9dbc3c0856ceccc2c3c5374d2d7b8a Mon Sep 17 00:00:00 2001
From: Maledong <maledong_public@foxmail.com>
Date: Sat, 14 Aug 2021 11:10:20 +0800
Subject: [PATCH 2/4] Update
 src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 .../src/ConfigurationExtensions.cs                              | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
index 89e8ae6ae59f55..21f6577d514b43 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
@@ -74,7 +74,7 @@ public static IEnumerable<KeyValuePair<string, string>> AsEnumerable(this IConfi
         /// Determines whether the section has a <see cref="IConfigurationSection.Value"/> or has children
         /// </summary>
         /// <param name="section">The <see cref="IConfigurationSection"/> to enumerate.</param>
-        /// <returns>A flag to indicate whether the section has values or not.</returns>
+        /// <returns><see langword="true" /> if the section has values or children; otherwise, <see langword="false" />.</returns>
         public static bool Exists(this IConfigurationSection section)
         {
             if (section == null)

From a8acab8ce7f17eeffd30801d6f736a4fbc7c9c16 Mon Sep 17 00:00:00 2001
From: Maledong <maledong_public@foxmail.com>
Date: Sat, 14 Aug 2021 11:10:32 +0800
Subject: [PATCH 3/4] Update
 src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 .../src/ConfigurationExtensions.cs                              | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
index 21f6577d514b43..381451af379d65 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
@@ -28,7 +28,7 @@ public static class ConfigurationExtensions
         /// <summary>
         /// Shorthand for GetSection("ConnectionStrings")[name].
         /// </summary>
-        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
+        /// <param name="configuration">The configuration to enumerate.</param>
         /// <param name="name">The connection string key.</param>
         /// <returns>The connection string.</returns>
         public static string GetConnectionString(this IConfiguration configuration, string name)

From bd8f813138e34c377566ac4bee0eee4b668fe7ed Mon Sep 17 00:00:00 2001
From: Maledong <maledong_public@foxmail.com>
Date: Sat, 14 Aug 2021 11:20:19 +0800
Subject: [PATCH 4/4] Update ConfigurationExtensions.cs

---
 .../src/ConfigurationExtensions.cs                     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
index 381451af379d65..71cc406e34d17c 100644
--- a/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
+++ b/src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationExtensions.cs
@@ -15,7 +15,7 @@ public static class ConfigurationExtensions
         /// <summary>
         /// Adds a new configuration source.
         /// </summary>
-        /// <param name="builder">The <see cref="IConfigurationBuilder"/> to add to.</param>
+        /// <param name="builder">The builder to add to.</param>
         /// <param name="configureSource">Configures the source secrets.</param>
         /// <returns>The <see cref="IConfigurationBuilder"/>.</returns>
         public static IConfigurationBuilder Add<TSource>(this IConfigurationBuilder builder, Action<TSource> configureSource) where TSource : IConfigurationSource, new()
@@ -39,14 +39,14 @@ public static string GetConnectionString(this IConfiguration configuration, stri
         /// <summary>
         /// Get the enumeration of key value pairs within the <see cref="IConfiguration" />
         /// </summary>
-        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
+        /// <param name="configuration">The configuration to enumerate.</param>
         /// <returns>An enumeration of key value pairs.</returns>
         public static IEnumerable<KeyValuePair<string, string>> AsEnumerable(this IConfiguration configuration) => configuration.AsEnumerable(makePathsRelative: false);
 
         /// <summary>
         /// Get the enumeration of key value pairs within the <see cref="IConfiguration" />
         /// </summary>
-        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
+        /// <param name="configuration">The configuration to enumerate.</param>
         /// <param name="makePathsRelative">If true, the child keys returned will have the current configuration's Path trimmed from the front.</param>
         /// <returns>An enumeration of key value pairs.</returns>
         public static IEnumerable<KeyValuePair<string, string>> AsEnumerable(this IConfiguration configuration, bool makePathsRelative)
@@ -73,7 +73,7 @@ public static IEnumerable<KeyValuePair<string, string>> AsEnumerable(this IConfi
         /// <summary>
         /// Determines whether the section has a <see cref="IConfigurationSection.Value"/> or has children
         /// </summary>
-        /// <param name="section">The <see cref="IConfigurationSection"/> to enumerate.</param>
+        /// <param name="section">The section to enumerate.</param>
         /// <returns><see langword="true" /> if the section has values or children; otherwise, <see langword="false" />.</returns>
         public static bool Exists(this IConfigurationSection section)
         {
@@ -87,7 +87,7 @@ public static bool Exists(this IConfigurationSection section)
         /// <summary>
         /// Gets a configuration sub-section with the specified key.
         /// </summary>
-        /// <param name="configuration">The <see cref="IConfiguration"/> to enumerate.</param>
+        /// <param name="configuration">The configuration to enumerate.</param>
         /// <param name="key">The key of the configuration section.</param>
         /// <returns>The <see cref="IConfigurationSection"/>.</returns>
         /// <remarks>