Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

Author: carlossanlop

xml/System.IO.Compression/BrotliCompressionOptions.xml

@@ -52,8 +52,8 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the compression quality for a Brotli compression stream.</summary>
-        <value>To be added.</value>
-        <remarks>The higher the quality, the slower the compression. Range is from 0 to 11. The default value is 4.</remarks>
+        <value>The compression quality for a Brotli compression stream. The default value is 4.</value>
+        <remarks>The higher the quality, the slower the compression. The range is from 0 to 11.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The value is less than 0 or greater than 11.</exception>
       </Docs>
     </Member>

xml/System.IO.Compression/ZLibCompressionOptions.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Provides compression options to be used with <see cref="T:System.IO.Compression.ZLibStream" />, <see cref="T:System.IO.Compression.DeflateStream" /> and <see cref="T:System.IO.Compression.GZipStream" />.</summary>
+    <summary>Provides compression options to be used with <see cref="T:System.IO.Compression.ZLibStream" />, <see cref="T:System.IO.Compression.DeflateStream" />, and <see cref="T:System.IO.Compression.GZipStream" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -52,10 +52,10 @@
       </ReturnValue>
       <Docs>
         <summary>Gets or sets the compression level for a compression stream.</summary>
-        <value>To be added.</value>
+        <value>The compression level for a compression stream. The default value is -1.</value>
         <remarks>
-          <para>Can accept any value between -1 and 9 (inclusive), 0 gives no compression,  1 gives best speed, 9 gives best compression.</para>
-          <para>and -1 requests the default compression level which is currently equivalent to 6. The default value is -1.</para>
+          <para>Can accept any value between -1 and 9 (inclusive). 0 gives no compression, 1 gives best speed, 9 gives best compression,</para>
+          <para>and -1 requests the default compression level, which is equivalent to 6.</para>
         </remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The value is less than -1 or greater than 9.</exception>
       </Docs>

xml/System.IO.Compression/ZLibCompressionStrategy.xml

@@ -13,7 +13,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>Defines  the compression algorithms that can be used for <see cref="T:System.IO.Compression.DeflateStream" />, <see cref="T:System.IO.Compression.GZipStream" /> or <see cref="T:System.IO.Compression.ZLibStream" />.</summary>
+    <summary>Defines the compression algorithms that can be used for <see cref="T:System.IO.Compression.DeflateStream" />, <see cref="T:System.IO.Compression.GZipStream" />, and <see cref="T:System.IO.Compression.ZLibStream" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -55,7 +55,7 @@
       <MemberValue>1</MemberValue>
       <Docs>
         <summary>
-          <para>Used for data produced by a filter (or predictor). The effect of Filtered is to force more Huffman coding and less string matching, intermediate between Default and HuffmanOnly.</para>
+          <para>Used for data produced by a filter (or predictor). The effect of Filtered is to force more Huffman coding and less string matching; it's an intermediate between Default and HuffmanOnly.</para>
         </summary>
       </Docs>
     </Member>
@@ -116,7 +116,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>Used to limit match distances to one (run-length encoding), give better compression for PNG image data.</summary>
+        <summary>Used to limit match distances to one (run-length encoding). Gives better compression for PNG image data.</summary>
       </Docs>
     </Member>
   </Members>

xml/System.IO.Compression/ZLibStream.xml

@@ -162,7 +162,7 @@
         <param name="compressionOptions">The ZLib options for fine tuning the compression stream.</param>
         <param name="leaveOpen">
           <see langword="true" /> to leave the stream object open after disposing the <see cref="T:System.IO.Compression.ZLibStream" /> object; otherwise, <see langword="false" />.</param>
-        <summary>Initializes a new instance of the <see cref="T:System.IO.Compression.ZLibStream" /> class by using the specified stream, compression options, and optionally leaves the stream open.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.IO.Compression.ZLibStream" /> class by using the specified stream and compression options, and optionally leaves the stream open.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="stream" /> or <paramref name="compressionOptions" /> is <see langword="null" />.</exception>