From eb70030a2960d7ee421cc63225cbdabc4ef2ecc5 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 7 Oct 2024 09:22:11 -0700
Subject: [PATCH 1/2] Update EnumConverter.xml (#10500)

---
 xml/System.ComponentModel/EnumConverter.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/xml/System.ComponentModel/EnumConverter.xml b/xml/System.ComponentModel/EnumConverter.xml
index 8443c7df80a..26ef5073575 100644
--- a/xml/System.ComponentModel/EnumConverter.xml
+++ b/xml/System.ComponentModel/EnumConverter.xml
@@ -62,10 +62,8 @@
  For more information about type converters, see the <xref:System.ComponentModel.TypeConverter> base class and [How to: Implement a Type Converter](https://learn.microsoft.com/previous-versions/visualstudio/visual-studio-2013/ayybcxe5(v=vs.120)).  
   
 > [!NOTE]
->  You should never create an instance of an <xref:System.ComponentModel.EnumConverter>. Instead, call the <xref:System.ComponentModel.TypeDescriptor.GetConverter%2A> method of the <xref:System.ComponentModel.TypeDescriptor> class. For more information, see the examples in the <xref:System.ComponentModel.TypeConverter> base class.  
-  
-   
-  
+> You should never create an instance of an <xref:System.ComponentModel.EnumConverter>. Instead, call the <xref:System.ComponentModel.TypeDescriptor.GetConverter%2A> method of the <xref:System.ComponentModel.TypeDescriptor> class. For more information, see the examples in the <xref:System.ComponentModel.TypeConverter> base class.
+
 ## Examples  
  The following code example converts a variable of type <xref:System.Enum> to a string, and vice versa. The example requires that you have declared an <xref:System.Enum> called `Servers` and that it has the following members:  
   
@@ -140,6 +138,8 @@ Windows=1, Exchange=2, BizTalk=3
         <param name="type">A <see cref="T:System.Type" /> that represents the type of enumeration to associate with this enumeration converter.</param>
         <summary>Initializes a new instance of the <see cref="T:System.ComponentModel.EnumConverter" /> class for the given type.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">.NET 9 and later versions: <paramref name="type" /> is not of an enum type.
+        </exception>
       </Docs>
     </Member>
     <Member MemberName="CanConvertFrom">

From f1c3d27e6024c767d369ecaff3315b2465b018b3 Mon Sep 17 00:00:00 2001
From: Steve Harter <steveharter@users.noreply.github.com>
Date: Mon, 7 Oct 2024 13:15:13 -0500
Subject: [PATCH 2/2] Add missing doc for ICustomTypeDescriptor (#10498)

---
 .../ICustomTypeDescriptor.xml                 | 43 +++++++++++++++----
 1 file changed, 34 insertions(+), 9 deletions(-)

diff --git a/xml/System.ComponentModel/ICustomTypeDescriptor.xml b/xml/System.ComponentModel/ICustomTypeDescriptor.xml
index 4cd0123b456..4cb0f786580 100644
--- a/xml/System.ComponentModel/ICustomTypeDescriptor.xml
+++ b/xml/System.ComponentModel/ICustomTypeDescriptor.xml
@@ -332,9 +332,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Gets a type converter for this object that may be registered.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns a type converter for this instance of a component that might be registered.</summary>
+        <returns>A <see cref="T:System.ComponentModel.TypeConverter" /> that is the converter for this object, or <see langword="null" /> if there is no <see cref="T:System.ComponentModel.TypeConverter" /> for this object.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ If `null` is returned, use the default <xref:System.ComponentModel.TypeConverter>.  
+  
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultEvent">
@@ -678,9 +685,18 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Gets the events for this instance of a component that may be registered.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns the events for this instance of a component that might be registered.</summary>
+        <returns>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for this component instance.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ The events for this instance can differ from the set of events that the class provides. For example, if the component is site-based, the site can add or remove additional events.  
+  
+ Implementors can return <xref:System.ComponentModel.EventDescriptorCollection.Empty?displayProperty=nameWithType> if no properties are specified. This method should never return `null`.  
+  
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <MemberGroup MemberName="GetProperties">
@@ -856,9 +872,18 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Gets the properties for this instance of a component that may be registered.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>Returns the properties for this instance of a component that might be registered.</summary>
+        <returns>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties for this component instance.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[  
+  
+## Remarks  
+ The properties for this instance can differ from the set of properties that the class provides. For example, if the component is sited, the site can add or remove additional properties.  
+  
+ Implementers can return <xref:System.ComponentModel.PropertyDescriptorCollection.Empty?displayProperty=nameWithType> if no properties are specified. This method should never return `null`.  
+  
+ ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetPropertyOwner">