Apply suggestions from code review

lonitra · gewarren · web-flow · commit 83b14b7cb23d · 2024-08-27T13:20:09.000-07:00
Co-authored-by: Genevieve Warren &lt;24882762+gewarren@users.noreply.github.com&gt;
diff --git a/xml/System.Drawing.Imaging.Effects/BrightnessContrastEffect.xml b/xml/System.Drawing.Imaging.Effects/BrightnessContrastEffect.xml
@@ -71,12 +71,9 @@
       </ReturnValue>
       <Docs>
         <summary>
-          <para>Integer in the range -255 through 255 that specifies the brightness level. If the value is 0, the brightness</para>
-          <para>remains the same. As the value moves from 0 to 255, the brightness of the image increases. As the value moves</para>
-          <para>from 0 to -255, the brightness of the image decreases.</para>
-        </summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+          <para>Gets an integer in the range -255 through 255 that specifies the brightness level.</para></summary>
+        <value>An integer in the range -255 through 255 that specifies the brightness level.</value>
+        <remarks>If the value is 0, the brightness remains the same. As the value moves from 0 to 255, the brightness of the image increases. As the value moves from 0 to -255, the brightness of the image decreases.</remarks>
       </Docs>
     </Member>
     <Member MemberName="ContrastLevel">
diff --git a/xml/System.Drawing.Imaging.Effects/ColorBalanceEffect.xml b/xml/System.Drawing.Imaging.Effects/ColorBalanceEffect.xml
@@ -60,7 +60,7 @@
             the amount of yellow increases.
           </para>
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorBalanceEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorBalanceEffect" /> with the specified red, green, and blue values.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <para>
diff --git a/xml/System.Drawing.Imaging.Effects/ColorCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/ColorCurveEffect.xml
@@ -34,7 +34,7 @@
         <ReturnType>System.Drawing.Imaging.Effects.CurveChannel</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The channel or channels that the effect is applied to.</summary>
+        <summary>Gets the channel or channels that the effect is applied to.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Drawing.Imaging.Effects/ColorLookupTableEffect.xml b/xml/System.Drawing.Imaging.Effects/ColorLookupTableEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Allows modification of the color components of an image.</summary>
+    <summary>Modifies the color components of an image.</summary>
     <remarks>Individual color component values are changed to entries in a series of lookup tables.</remarks>
   </Docs>
   <Members>
@@ -47,7 +47,7 @@
         <param name="greenLookupTable">The lookup table for the green channel.</param>
         <param name="blueLookupTable">The lookup table for the blue channel.</param>
         <param name="alphaLookupTable">The lookup table for the alpha channel.</param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorLookupTableEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorLookupTableEffect" /> with the specified red, green, blue, and alpha lookup tables.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">A lookup table parameter is longer than 256 bytes.</exception>
       </Docs>
@@ -96,7 +96,7 @@
         <ReturnType>System.ReadOnlyMemory&lt;System.Byte&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The lookup table for the alpha channel.</summary>
+        <summary>Gets the lookup table for the alpha channel.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -117,7 +117,7 @@
         <ReturnType>System.ReadOnlyMemory&lt;System.Byte&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The lookup table for the blue channel.</summary>
+        <summary>Gets the lookup table for the blue channel.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -138,7 +138,7 @@
         <ReturnType>System.ReadOnlyMemory&lt;System.Byte&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The lookup table for the green channel.</summary>
+        <summary>Gets the lookup table for the green channel.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -159,7 +159,7 @@
         <ReturnType>System.ReadOnlyMemory&lt;System.Byte&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The lookup table for the red channel.</summary>
+        <summary>Gets the lookup table for the red channel.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Drawing.Imaging.Effects/ColorMatrixEffect.xml b/xml/System.Drawing.Imaging.Effects/ColorMatrixEffect.xml
@@ -24,7 +24,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>Color matrix adjustment effect.</summary>
+    <summary>Adjusts the color matrix effect.</summary>
     <remarks>
       <para>
         See <see href="https://learn.microsoft.com/windows/win32/gdiplus/-gdiplus-recoloring-use">Recoloring</see> 
@@ -70,7 +70,7 @@
         <ReturnType>System.Drawing.Imaging.ColorMatrix</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The color transform matrix.</summary>
+        <summary>Gets the color transform matrix.</summary>
         <value>To be added.</value>
         <remarks>
           <para>
diff --git a/xml/System.Drawing.Imaging.Effects/ContrastCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/ContrastCurveEffect.xml
@@ -38,7 +38,7 @@
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="contrast">
           <para>
-            A value in the range of -100 through 100. A value of 0 specifies no change in contrast. Positive values
+            A value in the range of -100 through 100 that specifies the contrast adjustment value. A value of 0 specifies no change in contrast. Positive values
             specify increased contrast and negative values specify decreased contrast.
           </para>
         </param>
@@ -64,8 +64,8 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>A value in the range of -100 through 100.</summary>
-        <value>A value of 0 specifies no change in contrast. Positive values specify increased contrast and negative values specify decreased contrast.</value>
+        <summary>A value in the range of -100 through 100 that specifies the contrast adjustment value.</summary>
+        <value>The contrast adjustment value. A value of 0 specifies no change in contrast. Positive values specify increased contrast, and negative values specify decreased contrast.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Drawing.Imaging.Effects/CurveChannel.xml b/xml/System.Drawing.Imaging.Effects/CurveChannel.xml
@@ -13,7 +13,7 @@
     <BaseTypeName>System.Enum</BaseTypeName>
   </Base>
   <Docs>
-    <summary>The <see cref="T:System.Drawing.Imaging.Effects.CurveChannel" /> enumeration specifies which color channels are affected by a <see cref="T:System.Drawing.Imaging.Effects.ColorCurveEffect" />.</summary>
+    <summary>Specifies which color channels are affected by a <see cref="T:System.Drawing.Imaging.Effects.ColorCurveEffect" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -34,7 +34,7 @@
       </ReturnValue>
       <MemberValue>0</MemberValue>
       <Docs>
-        <summary>Specifies that the color adjustment applies to all channels.</summary>
+        <summary>The color adjustment applies to all channels.</summary>
       </Docs>
     </Member>
     <Member MemberName="Blue">
@@ -54,7 +54,7 @@
       </ReturnValue>
       <MemberValue>3</MemberValue>
       <Docs>
-        <summary>Specifies that the color adjustment applies only to the blue channel.</summary>
+        <summary>The color adjustment applies only to the blue channel.</summary>
       </Docs>
     </Member>
     <Member MemberName="Green">
@@ -74,7 +74,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>Specifies that the color adjustment applies only to the green channel.</summary>
+        <summary>The color adjustment applies only to the green channel.</summary>
       </Docs>
     </Member>
     <Member MemberName="Red">
@@ -94,7 +94,7 @@
       </ReturnValue>
       <MemberValue>1</MemberValue>
       <Docs>
-        <summary>Specifies that the color adjustment applies only to the red channel.</summary>
+        <summary>The color adjustment applies only to the red channel.</summary>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Drawing.Imaging.Effects/DensityCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/DensityCurveEffect.xml
@@ -37,7 +37,7 @@
       <Docs>
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="density">
-          A value in the range of -256 through 256. A value of 0 specifies no change in density. Positive values specify
+          A value in the range of -256 through 256 that specifies the density. A value of 0 specifies no change in density. Positive values specify
           increased density (lighter picture) and negative values specify decreased density (darker picture).
         </param>
         <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.DensityCurveEffect" /> with the given <paramref name="density" />.</summary>
@@ -63,7 +63,7 @@
       </ReturnValue>
       <Docs>
         <summary>
-          A value in the range of -256 through 256. A value of 0 specifies no change in density. Positive values specify
+          A value in the range of -256 through 256 that specifies the density. A value of 0 specifies no change in density. Positive values specify
           increased density (lighter picture) and negative values specify decreased density (darker picture).
         </summary>
         <value>To be added.</value>
diff --git a/xml/System.Drawing.Imaging.Effects/ExposureCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/ExposureCurveEffect.xml
@@ -37,7 +37,7 @@
       <Docs>
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="exposure">
-          A value in the range of -256 through 256. A value of 0 specifies no change in exposure. Positive values
+          A value in the range of -256 through 256 that specifies the exposure. A value of 0 specifies no change in exposure. Positive values
           specify increased exposure and negative values specify decreased exposure.
         </param>
         <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ExposureCurveEffect" /> with the given <paramref name="exposure" /> adjustment.</summary>
diff --git a/xml/System.Drawing.Imaging.Effects/GrayScaleEffect.xml b/xml/System.Drawing.Imaging.Effects/GrayScaleEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Effect that converts an image to grayscale.</summary>
+    <summary>Produces the effect that converts an image to grayscale.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Drawing.Imaging.Effects/HighlightCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/HighlightCurveEffect.xml
@@ -40,7 +40,7 @@
       <Docs>
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="highlight">
-          A value in the range of -100 through 100. A value of 0 specifies no change. Positive values specify that the
+          A value in the range of -100 through 100 that specifies the highlight value. A value of 0 specifies no change. Positive values specify that the
           light areas are made lighter, and negative values specify that the light areas are made darker.
         </param>
         <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.HighlightCurveEffect" /> with the given <paramref name="highlight" /> adjustment.</summary>
diff --git a/xml/System.Drawing.Imaging.Effects/InvertEffect.xml b/xml/System.Drawing.Imaging.Effects/InvertEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Effect that inverts the colors in an image.</summary>
+    <summary>Produces the effect that inverts the colors in an image.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Drawing.Imaging.Effects/LevelsEffect.xml b/xml/System.Drawing.Imaging.Effects/LevelsEffect.xml
@@ -45,7 +45,7 @@
         <param name="shadow">
           Integer in the range 0 through 100 that specifies which pixels should be darkened.
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.LevelsEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.LevelsEffect" /> with the specified highlight, midtone, and shadow values.</summary>
         <remarks>
           <para>
             For the <paramref name="highlight"/>, you can use this adjustment
@@ -93,7 +93,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The highlight threshold.</summary>
+        <summary>Gets the highlight threshold.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -114,7 +114,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The midtone adjustment.</summary>
+        <summary>Gets the midtone adjustment.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -135,7 +135,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The shadow threshold.</summary>
+        <summary>Gets the shadow threshold.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Drawing.Imaging.Effects/MidtoneCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/MidtoneCurveEffect.xml
@@ -45,8 +45,8 @@
       <Docs>
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="midtone">
-          A value in the range of -100 through 100. A value of 0 specifies no change. Positive values specify that the
-          mid-tones are made lighter, and negative values specify that the mid-tones are made darker.
+          A value in the range of -100 through 100 that specifies the midtone adjustment value. A value of 0 specifies no change. Positive values specify that the
+          midtones are made lighter, and negative values specify that the midtones are made darker.
         </param>
         <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.MidtoneCurveEffect" /> with the given <paramref name="midtone" /> adjustment.</summary>
         <remarks>To be added.</remarks>
@@ -74,8 +74,8 @@
           Gets the midtone value.
         </summary>
         <value>
-          A value in the range of -100 through 100. A value of 0 specifies no change. Positive values specify that the
-          mid-tones are made lighter, and negative values specify that the mid-tones are made darker.
+          A value in the range of -100 through 100 that specifies the midtone adjustment value. A value of 0 specifies no change. Positive values specify that the
+          midtones are made lighter, and negative values specify that the midtones are made darker.
         </value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Drawing.Imaging.Effects/SepiaEffect.xml b/xml/System.Drawing.Imaging.Effects/SepiaEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Effect that converts an image to sepia.</summary>
+    <summary>Produces the effect that converts an image to sepia.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Drawing.Imaging.Effects/ShadowCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/ShadowCurveEffect.xml
@@ -40,10 +40,10 @@
       <Docs>
         <param name="channel">The channel or channels that the effect is applied to.</param>
         <param name="shadow">
-          <para>A value in the range of -100 through 100. A value of 0 specifies no change. Positive values specify that the</para>
+          <para>A value in the range of -100 through 100 that specifies the shadow adjustment value. A value of 0 specifies no change. Positive values specify that the</para>
           <para>dark areas are made lighter, and negative values specify that the dark areas are made darker.</para>
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ShadowCurveEffect" /> with the given <paramref name="shadow" />.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ShadowCurveEffect" /> with the given shadow adjustment value.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="shadow" /> is less than -100 or greater than 100.</exception>
diff --git a/xml/System.Drawing.Imaging.Effects/SharpenEffect.xml b/xml/System.Drawing.Imaging.Effects/SharpenEffect.xml
@@ -44,7 +44,7 @@
           Real number in the range 0 through 100 that specifies the amount of sharpening to be applied. A value of 0
           specifies no sharpening. As the value of amount increases, the sharpness increases.
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.SharpenEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.SharpenEffect" /> with the specified sharpening values.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <para>
diff --git a/xml/System.Drawing.Imaging.Effects/TintEffect.xml b/xml/System.Drawing.Imaging.Effects/TintEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Allows you to apply a tint to an image.</summary>
+    <summary>Applies a tint to an image.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -41,7 +41,7 @@
           strengthened or weakened. A value of 0 specifies no change. Positive values specify that the hue is
           strengthened and negative values specify that the hue is weakened
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.TintEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.TintEffect" /> with the specified hue adjustment.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="amount" /> is less than -100 or greater than 100.</exception>
@@ -92,7 +92,7 @@
       </ReturnValue>
       <Docs>
         <summary>
-          Gets the hue amount that is strengthened or weakened.
+          Gets the amount that the hue is strengthened or weakened.
         </summary>
         <value>
           Integer in the range -100 through 100 that specifies how much the hue (given by the hue property) is
diff --git a/xml/System.Drawing.Imaging.Effects/VividEffect.xml b/xml/System.Drawing.Imaging.Effects/VividEffect.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>Effect that makes colors more vivid.</summary>
+    <summary>Produces the effect that makes colors more vivid.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
diff --git a/xml/System.Drawing.Imaging.Effects/WhiteSaturationCurveEffect.xml b/xml/System.Drawing.Imaging.Effects/WhiteSaturationCurveEffect.xml
@@ -42,7 +42,7 @@
         <param name="whiteSaturation">
           A value of t specifies that the interval [0, t] is mapped linearly to the interval [0, 255]. For example, if
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.WhiteSaturationCurveEffect" /> with the given parameters.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.WhiteSaturationCurveEffect" /> with the specified white saturation value.</summary>
         <remarks>
           <para>
             For example, if <paramref name="whiteSaturation" /> is equal to 240, then color channel values in the interval [0, 240] are adjusted
@@ -72,7 +72,7 @@
         <summary>
           Gets the white saturation value.</summary>
         <value>
-          A value of t specifies that the interval [0, t] is mapped linearly to the interval [0, 255]. For example, if<see cref="P:System.Drawing.Imaging.Effects.WhiteSaturationCurveEffect.WhiteSaturation" /> 
+          A value of t specifies that the interval [0, t] is mapped linearly to the interval [0, 255]. For example, if <see cref="P:System.Drawing.Imaging.Effects.WhiteSaturationCurveEffect.WhiteSaturation" /> 
           is equal to 240, then color channel values in the interval [0, 240] are adjusted so that they spread out over the interval [0, 255]. Color channel values greater than 240 are set to 255.
         </value>
         <remarks>To be added.</remarks>
diff --git a/xml/System.Drawing.Imaging/ColorPalette.xml b/xml/System.Drawing.Imaging/ColorPalette.xml
diff --git a/xml/System.Drawing.Imaging/DitherType.xml b/xml/System.Drawing.Imaging/DitherType.xml
diff --git a/xml/System.Drawing.Imaging/PaletteType.xml b/xml/System.Drawing.Imaging/PaletteType.xml
