Convert first batch of XML docs to inline documentation

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Author: 2 people

src/Controls/src/Core/EditorAutoSizeOption.cs

@@ -4,12 +4,12 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/EditorAutoSizeOption.xml" path="Type[@FullName='Microsoft.Maui.Controls.EditorAutoSizeOption']/Docs/*" />
+	/// <summary>Enumerates values that control whether an editor will change size to accommodate input as the user enters it.</summary>
 	public enum EditorAutoSizeOption
 	{
-		/// <include file="../../docs/Microsoft.Maui.Controls/EditorAutoSizeOption.xml" path="//Member[@MemberName='Disabled']/Docs/*" />
+		/// <summary>Automatic resizing is not enabled. This is the default value.</summary>
 		Disabled = 0,
-		/// <include file="../../docs/Microsoft.Maui.Controls/EditorAutoSizeOption.xml" path="//Member[@MemberName='TextChanges']/Docs/*" />
+		/// <summary>Automatic resizing is enabled.</summary>
 		TextChanges = 1
 	}
 }

src/Controls/src/Core/HtmlWebViewSource.cs

@@ -3,7 +3,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/HtmlWebViewSource.xml" path="Type[@FullName='Microsoft.Maui.Controls.HtmlWebViewSource']/Docs/*" />
+	/// <summary>A WebViewSource bound to an HTML-formatted string.</summary>
 	public class HtmlWebViewSource : WebViewSource
 	{
 		/// <summary>Bindable property for <see cref="Html"/>.</summary>
@@ -14,21 +14,22 @@ public class HtmlWebViewSource : WebViewSource
 		public static readonly BindableProperty BaseUrlProperty = BindableProperty.Create(nameof(BaseUrl), typeof(string), typeof(HtmlWebViewSource), default(string),
 			propertyChanged: (bindable, oldvalue, newvalue) => ((HtmlWebViewSource)bindable).OnSourceChanged());
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/HtmlWebViewSource.xml" path="//Member[@MemberName='BaseUrl']/Docs/*" />
+		/// <summary>The base URL for the source HTML document. This is a bindable property.</summary>
 		public string BaseUrl
 		{
 			get { return (string)GetValue(BaseUrlProperty); }
 			set { SetValue(BaseUrlProperty, value); }
 		}
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/HtmlWebViewSource.xml" path="//Member[@MemberName='Html']/Docs/*" />
+		/// <summary>The HTML content. This is a bindable property.</summary>
 		public string Html
 		{
 			get { return (string)GetValue(HtmlProperty); }
 			set { SetValue(HtmlProperty, value); }
 		}
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/HtmlWebViewSource.xml" path="//Member[@MemberName='Load']/Docs/*" />
+		/// <summary>Loads the specified <paramref name="renderer"/> with the current base URL and HTML.</summary>
+		/// <param name="renderer">The renderer into which to load html content.</param>
 		[EditorBrowsable(EditorBrowsableState.Never)]
 		public override void Load(IWebViewDelegate renderer)
 		{

src/Controls/src/Core/HtmlWebViewSource.cs.converted

@@ -0,0 +1,39 @@
+#nullable disable
+using System.ComponentModel;
+
+namespace Microsoft.Maui.Controls
+{
+	/// <summary>A WebViewSource bound to an HTML-formatted string.</summary>
+	public class HtmlWebViewSource : WebViewSource
+	{
+		/// <summary>Bindable property for <see cref="Html"/>.</summary>
+		public static readonly BindableProperty HtmlProperty = BindableProperty.Create(nameof(Html), typeof(string), typeof(HtmlWebViewSource), default(string),
+			propertyChanged: (bindable, oldvalue, newvalue) => ((HtmlWebViewSource)bindable).OnSourceChanged());
+
+		/// <summary>Bindable property for <see cref="BaseUrl"/>.</summary>
+		public static readonly BindableProperty BaseUrlProperty = BindableProperty.Create(nameof(BaseUrl), typeof(string), typeof(HtmlWebViewSource), default(string),
+			propertyChanged: (bindable, oldvalue, newvalue) => ((HtmlWebViewSource)bindable).OnSourceChanged());
+
+		/// <summary>The base URL for the source HTML document.</summary>
+		public string BaseUrl
+		{
+			get { return (string)GetValue(BaseUrlProperty); }
+			set { SetValue(BaseUrlProperty, value); }
+		}
+
+		/// <summary>The HTML content. This is a bindable property.</summary>
+		public string Html
+		{
+			get { return (string)GetValue(HtmlProperty); }
+			set { SetValue(HtmlProperty, value); }
+		}
+
+		/// <summary>Loads the specified <paramref name="renderer"/> with the current base URL and HTML.</summary>
+		/// <param name="renderer">The renderer into which to load html content.</param>
+		[EditorBrowsable(EditorBrowsableState.Never)]
+		public override void Load(IWebViewDelegate renderer)
+		{
+			renderer.LoadHtml(Html, BaseUrl);
+		}
+	}
+}

src/Controls/src/Core/ListStringTypeConverter.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/ListStringTypeConverter.xml" path="Type[@FullName='Microsoft.Maui.Controls.ListStringTypeConverter']/Docs/*" />
+	/// <summary>Type converter for converting properly formatted string lists to lists.</summary>
 	[Xaml.ProvideCompiled("Microsoft.Maui.Controls.XamlC.ListStringTypeConverter")]
 	public class ListStringTypeConverter : TypeConverter
 	{

src/Controls/src/Core/SolidColorBrush.cs

@@ -41,7 +41,7 @@ public virtual Color Color
 			set => SetValue(ColorProperty, value);
 		}
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/SolidColorBrush.xml" path="//Member[@MemberName='Equals']/Docs/*" />
+		/// <param name="obj">To be added.</param>
 		public override bool Equals(object obj)
 		{
 			if (!(obj is SolidColorBrush dest))