From 8d5c3030316d2f147e33c269f16a275a756f5e26 Mon Sep 17 00:00:00 2001
From: Tarek Mahmoud Sayed <tarekms@microsoft.com>
Date: Thu, 21 Jul 2022 18:57:08 -0700
Subject: [PATCH] Port the doc changes to source (#72638)

* Port the doc changes to source

* Address the feedback

* Update src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/DateOnlyConverter.cs

Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>

* Remove duplicated summary section

* reorder the doc elements

* reorder the remaining doc elements

Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
---
 .../src/System/ComponentModel/DateOnlyConverter.cs | 14 ++++++--------
 .../src/System/ComponentModel/TimeOnlyConverter.cs | 14 ++++++--------
 2 files changed, 12 insertions(+), 16 deletions(-)

diff --git a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/DateOnlyConverter.cs b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/DateOnlyConverter.cs
index c036846b97acd..5bfe8223a8600 100644
--- a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/DateOnlyConverter.cs
+++ b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/DateOnlyConverter.cs
@@ -9,25 +9,21 @@
 namespace System.ComponentModel
 {
     /// <summary>
-    /// Provides a type converter to convert <see cref='System.DateOnly'/>
-    /// objects to and from various other representations.
+    /// Provides a type converter to convert <see cref='System.DateOnly'/> objects to and from various other representations.
     /// </summary>
     public class DateOnlyConverter : TypeConverter
     {
         /// <summary>
-        /// Gets a value indicating whether this converter can convert an
-        /// object in the given source type to a <see cref='System.DateOnly'/>
+        /// Gets a value indicating whether this converter can convert an object in the given source type to a <see cref='System.DateOnly'/>
         /// object using the specified context.
         /// </summary>
+        /// <inheritdoc />
         public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)
         {
             return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
         }
 
-        /// <summary>
-        /// Gets a value indicating whether this converter can convert an object
-        /// to the given destination type using the context.
-        /// </summary>
+        /// <inheritdoc />
         public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(true)] Type? destinationType)
         {
             return destinationType == typeof(InstanceDescriptor) || base.CanConvertTo(context, destinationType);
@@ -36,6 +32,7 @@ public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(
         /// <summary>
         /// Converts the given value object to a <see cref='System.DateOnly'/> object.
         /// </summary>
+        /// <inheritdoc />
         public override object? ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)
         {
             if (value is string text)
@@ -77,6 +74,7 @@ public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(
         /// <summary>
         /// Converts the given value object from a <see cref='System.DateOnly'/> object using the arguments.
         /// </summary>
+        /// <inheritdoc />
         public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type destinationType)
         {
             if (destinationType == typeof(string) && value is DateOnly dateOnly)
diff --git a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TimeOnlyConverter.cs b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TimeOnlyConverter.cs
index 7dc61debaf41d..4180508d2cc99 100644
--- a/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TimeOnlyConverter.cs
+++ b/src/libraries/System.ComponentModel.TypeConverter/src/System/ComponentModel/TimeOnlyConverter.cs
@@ -9,25 +9,21 @@
 namespace System.ComponentModel
 {
     /// <summary>
-    /// Provides a type converter to convert <see cref='System.TimeOnly'/>
-    /// objects to and from various other representations.
+    /// Provides a type converter to convert <see cref='System.TimeOnly'/> objects to and from various other representations.
     /// </summary>
     public class TimeOnlyConverter : TypeConverter
     {
         /// <summary>
-        /// Gets a value indicating whether this converter can convert an
-        /// object in the given source type to a <see cref='System.TimeOnly'/>
+        /// Gets a value indicating whether this converter can convert an object in the given source type to a <see cref='System.TimeOnly'/>
         /// object using the specified context.
         /// </summary>
+        /// <inheritdoc />
         public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)
         {
             return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
         }
 
-        /// <summary>
-        /// Gets a value indicating whether this converter can convert an object
-        /// to the given destination type using the context.
-        /// </summary>
+        /// <inheritdoc />
         public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(true)] Type? destinationType)
         {
             return destinationType == typeof(InstanceDescriptor) || base.CanConvertTo(context, destinationType);
@@ -36,6 +32,7 @@ public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(
         /// <summary>
         /// Converts the given value object to a <see cref='System.TimeOnly'/> object.
         /// </summary>
+        /// <inheritdoc />
         public override object? ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)
         {
             if (value is string text)
@@ -77,6 +74,7 @@ public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(
         /// <summary>
         /// Converts the given value object from a <see cref='System.TimeOnly'/> object using the arguments.
         /// </summary>
+        /// <inheritdoc />
         public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type destinationType)
         {
             if (destinationType == typeof(string) && value is TimeOnly timeOnly)