dotnet · dotnet-policy-service · Sep 10, 2024 · Sep 9, 2024 · Sep 10, 2024 · Sep 10, 2024
diff --git a/xml/System.ComponentModel/ComponentResourceManager.xml b/xml/System.ComponentModel/ComponentResourceManager.xml
@@ -349,9 +349,9 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="objectName">To be added.</param>
-        <param name="culture">To be added.</param>
+        <param name="value">An <see cref="T:System.Object" /> that contains the property value to be applied.</param>
+        <param name="objectName">A <see cref="T:System.String" /> that contains the name of the object to look up in the resources.</param>
+        <param name="culture">The culture for which to apply resources.</param>
         <summary>
           <para>Examines all the resources for the provided culture.</para>
           <para>When it finds a resource with a key in the format of</para>

diff --git a/xml/System.ComponentModel/CustomTypeDescriptor.xml b/xml/System.ComponentModel/CustomTypeDescriptor.xml
@@ -490,7 +490,7 @@
           <para>Returns a type converter for the type this type</para>
           <para>descriptor is representing.</para>
         </summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the type represented by this type descriptor.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -881,7 +881,7 @@
           <para>Returns a collection of event descriptors</para>
           <para>for the object this type descriptor is representing.</para>
         </summary>
-        <returns>To be added.</returns>
+        <returns>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> containing the event descriptors for the object represented by this type descriptor.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1078,7 +1078,7 @@
           <para>Returns a collection of property descriptors</para>
           <para>for the object this type descriptor is representing.</para>
         </summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the property descriptions for the object represented by this type descriptor.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.ComponentModel/TypeDescriptionProvider.xml b/xml/System.ComponentModel/TypeDescriptionProvider.xml
@@ -437,10 +437,10 @@
         <Parameter Name="instance" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="instance">To be added.</param>
+        <param name="instance">The object for which to get the extended type descriptor.</param>
         <summary>Returns an extended custom type descriptor for the given object.</summary>
-        <returns>To be added.</returns>
-        <remarks>An extended type descriptor is a custom type descriptor that offers properties that other objects have added to this object, but are not actually defined on the object. For example, in the .NET Framework Component Model, objects that implement the interface IExtenderProvider can "attach" properties to other objects that reside in the same logical container. The GetTypeDescriptor method does not return a type descriptor that provides these extra extended properties. GetExtendedTypeDescriptor returns the set of these extended properties. TypeDescriptor will automatically merge the results of these two property collections. Note that while the .NET Framework component model only supports extended properties this API can be used for extended attributes and events as well, if the type description provider supports it.</remarks>
+        <returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide extended metadata for the object.</returns>
+        <remarks>An extended type descriptor is a custom type descriptor that offers properties that other objects have added to this object, but are not actually defined on the object. For example, in the .NET Framework Component Model, objects that implement the interface IExtenderProvider can "attach" properties to other objects that reside in the same logical container. The GetTypeDescriptorFromRegisteredType method does not return a type descriptor that provides these extra extended properties. GetExtendedTypeDescriptorFromRegisteredType returns the set of these extended properties. TypeDescriptor will automatically merge the results of these two property collections. Note that while the .NET Framework component model only supports extended properties this API can be used for extended attributes and events as well, if the type description provider supports it.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetExtenderProviders">
@@ -1035,10 +1035,10 @@
         <Parameter Name="instance" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="instance">To be added.</param>
+        <param name="instance">An instance of the type. Can be <see langword="null" /> if no instance was passed to the <see cref="T:System.ComponentModel.TypeDescriptor" />.</param>
         <summary>Returns a custom type descriptor for the given type or object.</summary>
-        <returns>To be added.</returns>
-        <remarks>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
+        <returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
+        <remarks>The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetTypeDescriptorFromRegisteredType">
@@ -1072,10 +1072,10 @@
         <Parameter Name="objectType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="objectType">To be added.</param>
+        <param name="objectType">The type of object for which to retrieve the type descriptor.</param>
         <summary>Returns a custom type descriptor for the given type or object.</summary>
-        <returns>To be added.</returns>
-        <remarks>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
+        <returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
+        <remarks>The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</remarks>
       </Docs>
     </Member>
     <Member MemberName="GetTypeDescriptorFromRegisteredType">
@@ -1117,10 +1117,10 @@
         <Parameter Name="instance" Type="System.Object" Index="1" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="objectType">To be added.</param>
-        <param name="instance">To be added.</param>
+        <param name="objectType">The type of object for which to retrieve the type descriptor.</param>
+        <param name="instance">An instance of the type. Can be <see langword="null" /> if no instance was passed to the <see cref="T:System.ComponentModel.TypeDescriptor" />.</param>
         <summary>Returns a custom type descriptor for the given type or object.</summary>
-        <returns>To be added.</returns>
+        <returns>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</returns>
         <remarks>
           <para>The objectType parameter is always valid, but the instance parameter may be <see langword="null" /> if no instance was passed to TypeDescriptor. The method should return a custom type descriptor for the object. If the method is not interested in providing type information for the object it should return base.</para>
           <para>This method is prototyped as virtual, and by default returns a custom type descriptor that returns empty collections for all values if no parent provider was passed. If a parent provider was passed, this method will invoke the parent provider's GetTypeDescriptorFromRegisteredType method.</para>
@@ -1152,9 +1152,9 @@
         <Parameter Name="type" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="type">To be added.</param>
+        <param name="type">The type to check if it was registered.</param>
         <summary>Determines whether the type was registered with its provider through <see cref="M:System.ComponentModel.TypeDescriptor.RegisterType``1" />.</summary>
-        <returns>To be added.</returns>
+        <returns><see langword="true" /> if <paramref name="type" /> is registered; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="type" /> is <see langword="null" />.</exception>

diff --git a/xml/System.ComponentModel/TypeDescriptor.xml b/xml/System.ComponentModel/TypeDescriptor.xml
@@ -2221,9 +2221,9 @@
         <Parameter Name="component" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="component">To be added.</param>
+        <param name="component">A component to get the converter for.</param>
         <summary>Gets a type converter for the type of the specified component.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified component.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2252,9 +2252,9 @@
         <Parameter Name="type" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="type">To be added.</param>
+        <param name="type">The <see cref="T:System.Type" /> of the target component.</param>
         <summary>Gets a type converter for the specified registered type.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -3510,9 +3510,9 @@
         <Parameter Name="componentType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="componentType">To be added.</param>
+        <param name="componentType">The <see cref="T:System.Type" /> of the target component.</param>
         <summary>Gets a collection of events for a specified type of component.</summary>
-        <returns>To be added.</returns>
+        <returns>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events for this component.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -4163,9 +4163,9 @@
         <Parameter Name="component" Type="System.Object" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="component">To be added.</param>
+        <param name="component">A component to get the properties for.</param>
         <summary>Gets a collection of properties for a specified component.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for the specified component.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -4194,9 +4194,9 @@
         <Parameter Name="componentType" Type="System.Type" Index="0" FrameworkAlternate="net-9.0" />
       </Parameters>
       <Docs>
-        <param name="componentType">To be added.</param>
+        <param name="componentType">A <see cref="T:System.Type" /> that represents the component to get properties for.</param>
         <summary>Gets a collection of properties for a specified type.</summary>
-        <returns>To be added.</returns>
+        <returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for a specified type of component.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Drawing2D/GraphicsPath.xml b/xml/System.Drawing.Drawing2D/GraphicsPath.xml
@@ -1650,6 +1650,7 @@
 
  ]]></format>
         </remarks>
+        <inheritdoc cref="M:System.Drawing.Drawing2D.GraphicsPath.AddCurve(System.Drawing.PointF[],System.Int32,System.Int32,System.Single)" />
       </Docs>
     </Member>
     <Member MemberName="AddCurve">

diff --git a/xml/System.Drawing.Drawing2D/Matrix.xml b/xml/System.Drawing.Drawing2D/Matrix.xml
@@ -1647,6 +1647,7 @@ Matrix myMatrix = new Matrix(3, 5, 1, 2, 2, 4);
         <param name="pts">To be added.</param>
         <summary>To be added.</summary>
         <remarks>To be added.</remarks>
+        <inheritdoc cref="M:System.Drawing.Drawing2D.Matrix.TransformPoints(System.Drawing.Point[])" />
       </Docs>
     </Member>
     <MemberGroup MemberName="TransformVectors">

diff --git a/xml/System.Drawing.Drawing2D/PathGradientBrush.xml b/xml/System.Drawing.Drawing2D/PathGradientBrush.xml
@@ -373,7 +373,7 @@
         <param name="points">To be added.</param>
         <summary>To be added.</summary>
         <remarks>To be added.</remarks>
-        <inheritdoc cref="M:System.Drawing.Drawing2D.PathGradientBrush.#ctor(System.Drawing.PointF[])" />
+        <inheritdoc cref="M:System.Drawing.Drawing2D.PathGradientBrush.#ctor(System.Drawing.PointF[],System.Drawing.Drawing2D.WrapMode)" />
       </Docs>
     </Member>
     <Member MemberName=".ctor">

diff --git a/xml/System.Drawing.Imaging.Effects/BlurEffect.xml b/xml/System.Drawing.Imaging.Effects/BlurEffect.xml
@@ -36,11 +36,13 @@
       </Parameters>
       <Docs>
         <param name="radius">
-          <para>
-            <see langword="true" /> to expand the bitmap by an amount equal to the blur radius so it can have soft edges. <see langword="false" /> to keep the bitmap the same size and clip the soft edges.
-          </para>
+            Real number that specifies the blur radius (the radius of the Gaussian convolution kernel) in pixels. The
+            radius must be in the range 0 through 256. As the radius increases, the resulting bitmap becomes more blurry.
         </param>
-        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.BlurEffect" /> with the given parameters.</summary>
+        <param name="expandEdge">
+          <see langword="true"/> to expand the bitmap by an amount equal to the blur radius so that it can have soft edges; <see langword="false"/> to keep the bitmap the same size and clip the soft edges.
+        </param>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.BlurEffect" /> with the specified blur radius.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="radius" /> is less than 0 or greater than 256.</exception>

diff --git a/xml/System.Drawing.Imaging.Effects/Effect.xml b/xml/System.Drawing.Imaging.Effects/Effect.xml
@@ -47,12 +47,12 @@
       </Docs>
     </Member>
     <Member MemberName="Dispose">
-      <MemberSignature Language="C#" Value="public virtual void Dispose (bool disposing);" />
-      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Dispose(bool disposing) cil managed" />
+      <MemberSignature Language="C#" Value="protected virtual void Dispose (bool disposing);" />
+      <MemberSignature Language="ILAsm" Value=".method protected hidebysig newslot virtual instance void Dispose(bool disposing) cil managed" />
       <MemberSignature Language="DocId" Value="M:System.Drawing.Imaging.Effects.Effect.Dispose(System.Boolean)" />
-      <MemberSignature Language="VB.NET" Value="Public Overridable Sub Dispose (disposing As Boolean)" />
+      <MemberSignature Language="VB.NET" Value="protected Overridable Sub Dispose (disposing As Boolean)" />
       <MemberSignature Language="F#" Value="abstract member Dispose : bool -&gt; unit&#xA;override this.Dispose : bool -&gt; unit" Usage="effect.Dispose disposing" />
-      <MemberSignature Language="C++ CLI" Value="public:&#xA; virtual void Dispose(bool disposing);" />
+      <MemberSignature Language="C++ CLI" Value="protected:&#xA; virtual void Dispose(bool disposing);" />
       <MemberType>Method</MemberType>
       <AssemblyInfo>
         <AssemblyName>System.Drawing.Common</AssemblyName>
@@ -87,7 +87,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Cleans up Windows resources for this <see cref="T:System.Drawing.Imaging.Effects.Effect" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Imaging.Effects/GrayScaleEffect.xml b/xml/System.Drawing.Imaging.Effects/GrayScaleEffect.xml
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates a <see cref="T:System.Drawing.Imaging.Effects.ColorMatrixEffect" /> that converts an image to grayscale.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Imaging.Effects/InvertEffect.xml b/xml/System.Drawing.Imaging.Effects/InvertEffect.xml
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates a <see cref="T:System.Drawing.Imaging.Effects.ColorMatrixEffect" /> that inverts the colors in an image.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Imaging.Effects/SepiaEffect.xml b/xml/System.Drawing.Imaging.Effects/SepiaEffect.xml
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorMatrixEffect" /> that converts an image to sepia.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Imaging.Effects/VividEffect.xml b/xml/System.Drawing.Imaging.Effects/VividEffect.xml
@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Creates a new <see cref="T:System.Drawing.Imaging.Effects.ColorMatrixEffect" /> that makes colors more vivid.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

diff --git a/xml/System.Drawing.Imaging/ColorMatrix.xml b/xml/System.Drawing.Imaging/ColorMatrix.xml
@@ -162,7 +162,7 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="newColorMatrix">To be added.</param>
+        <param name="newColorMatrix">The values of the elements of the new matrix.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Drawing.Imaging.ColorMatrix" /> class with the elements in the specified matrix.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">