Update ConfigurationExtensions.xml (#7658)

Author: gewarren

xml/Microsoft.Extensions.Configuration/ConfigurationExtensions.xml

@@ -150,7 +150,7 @@
       <Docs>
         <param name="configuration">To be added.</param>
         <param name="userSecretsId">To be added.</param>
-        <summary>Adds the user secrets configuration source with specified secrets id.</summary>
+        <summary>Adds the user secrets configuration source with specified secrets ID.</summary>
         <returns />
         <remarks>To be added.</remarks>
       </Docs>
@@ -224,8 +224,8 @@
       </Parameters>
       <Docs>
         <param name="configuration">The <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> to enumerate.</param>
-        <summary>Get the enumeration of key value pairs within the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" />.</summary>
-        <returns>An enumeration of key value pairs.</returns>
+        <summary>Get the enumeration of key-value pairs within the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" />.</summary>
+        <returns>An enumeration of key-value pairs.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -268,9 +268,10 @@
       </Parameters>
       <Docs>
         <param name="configuration">The <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> to enumerate.</param>
-        <param name="makePathsRelative">If true, the child keys returned will have the current configuration's Path trimmed from the front.</param>
-        <summary>Get the enumeration of key value pairs within the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" />.</summary>
-        <returns>An enumeration of key value pairs.</returns>
+        <param name="makePathsRelative">
+          <see langword="true" /> to trim the the current configuration's Path from the child keys returned; otherwise, <see langword="false" />.</param>
+        <summary>Gets the enumeration of key-value pairs within the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" />.</summary>
+        <returns>An enumeration of key-value pairs.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -336,8 +337,8 @@
       <Docs>
         <param name="configuration">The configuration.</param>
         <param name="name">The connection string key.</param>
-        <summary>Shorthand for GetSection("ConnectionStrings")[name].</summary>
-        <returns>The connection string.</returns>
+        <summary>Retrieves the value with the specified key from the <code>ConnectionStrings</code> section of the configuration source. Calling this method is shorthand for <code>GetSection("ConnectionStrings")[name]</code>.</summary>
+        <returns>The connection string with the specified key.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -363,14 +364,14 @@
       <Docs>
         <param name="configuration">The configuration to enumerate.</param>
         <param name="key">The key of the configuration section.</param>
-        <summary>Gets a configuration sub-section with the specified key.</summary>
-        <returns>The <see cref="T:Microsoft.Extensions.Configuration.IConfigurationSection" />.</returns>
+        <summary>Gets the configuration subsection that has the specified key.</summary>
+        <returns>The configuration subsection that has the specified key.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-If no matching sub-section is found with the specified key, an exception is raised.
+If no matching subsection is found with the specified key, an exception is raised.
 
           ]]></format>
         </remarks>