Convert third batch of XML docs to inline documentation

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

# Conflicts:
#	src/Controls/src/Core/BoxView/BoxView.cs

Author: Copilot

src/Controls/src/Core/BoundsConstraint.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/BoundsConstraint.xml" path="Type[@FullName='Microsoft.Maui.Controls.BoundsConstraint']/Docs/*" />
+	/// <summary>A bounds layout constraint used by <see cref="T:Microsoft.Maui.Controls.Compatibility.RelativeLayout"/>s.</summary>
 	public class BoundsConstraint
 	{
 		Func<Rect> _measureFunc;
@@ -19,7 +19,9 @@ public class BoundsConstraint
 		internal bool CreatedFromExpression { get; set; }
 		internal IEnumerable<View> RelativeTo { get; set; }
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/BoundsConstraint.xml" path="//Member[@MemberName='FromExpression']/Docs/*" />
+		/// <summary>Returns a <see cref="T:Microsoft.Maui.Controls.BoundsConstraint"/> object that contains the compiled version of <paramref name="expression"/> and is relative to either <paramref name="parents"/> or the views referred to in <paramref name="expression"/>.</summary>
+		/// <param name="expression">The expression from which to compile the constraint.</param>
+		/// <param name="parents">The parents to consider when compiling the constraint.</param>
 		public static BoundsConstraint FromExpression(Expression<Func<Rect>> expression, IEnumerable<View> parents = null)
 		{
 			return FromExpression(expression, false, parents);

src/Controls/src/Core/Button/ButtonsMask.cs

@@ -4,7 +4,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/ButtonsMask.xml" path="Type[@FullName='Microsoft.Maui.Controls.ButtonsMask']/Docs" />
+	/// <summary>Flag values that represent mouse buttons.</summary>
 	[Flags]
 	public enum ButtonsMask
 	{

src/Controls/src/Core/CarouselPage/CarouselPage.cs

@@ -8,7 +8,7 @@ internal class CarouselPage : MultiPage<ContentPage>, IElementConfiguration<Caro
 	{
 		readonly Lazy<PlatformConfigurationRegistry<CarouselPage>> _platformConfigurationRegistry;
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/CarouselPage.xml" path="//Member[@MemberName='.ctor']/Docs/*" />
+		/// <summary>Initializes a new instance of the CarouselPage class.</summary>
 		public CarouselPage()
 		{
 			_platformConfigurationRegistry = new Lazy<PlatformConfigurationRegistry<CarouselPage>>(() => new PlatformConfigurationRegistry<CarouselPage>(this));

src/Controls/src/Core/Cells/Cell.cs

@@ -10,10 +10,10 @@
 namespace Microsoft.Maui.Controls
 {
 	// Don't add IElementConfiguration<Cell> because it kills performance on UWP structures that use Cells
-	/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="Type[@FullName='Microsoft.Maui.Controls.Cell']/Docs/*" />
+	/// <summary>Provides base class and capabilities for all Microsoft.Maui.Controls cells. Cells are elements meant to be added to <see cref="T:Microsoft.Maui.Controls.ListView"/> or <see cref="T:Microsoft.Maui.Controls.TableView"/>.</summary>
 	public abstract class Cell : Element, ICellController, IFlowDirectionController, IPropertyPropagationController, IVisualController, IWindowController, IVisualTreeElement
 	{
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='DefaultCellHeight']/Docs/*" />
+		/// <summary>The default height of cells.</summary>
 		public const int DefaultCellHeight = 40;
 		/// <summary>Bindable property for <see cref="IsEnabled"/>.</summary>
 		public static readonly BindableProperty IsEnabledProperty = BindableProperty.Create(nameof(IsEnabled), typeof(bool), typeof(Cell), true, propertyChanged: OnIsEnabledPropertyChanged);
@@ -26,7 +26,8 @@ public abstract class Cell : Element, ICellController, IFlowDirectionController,
 
 		bool _nextCallToForceUpdateSizeQueued;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='.ctor']/Docs/*" />
+		/// <summary>Initializes a new instance of the Cell class.</summary>
+		/// <remarks>Cell class is abstract, this constructor is never invoked directly.</remarks>
 		public Cell()
 		{
 			_elementConfiguration = new Lazy<ElementConfiguration>(() => new ElementConfiguration(this));
@@ -83,7 +84,8 @@ Window IWindowController.Window
 			}
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='ContextActions']/Docs/*" />
+		/// <summary>Gets a list of menu items to display when the user performs the device-specific context gesture on the Cell.</summary>
+		/// <remarks>The context gesture on the iOS platform is a left swipe. For Android and Windows Phone operating systems, the context gesture is a press and hold.</remarks>
 		public IList<MenuItem> ContextActions
 		{
 			get
@@ -98,7 +100,7 @@ public IList<MenuItem> ContextActions
 			}
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='HasContextActions']/Docs/*" />
+		/// <summary>Gets a value that indicates whether the cell has at least one menu item in its <see cref="P:Microsoft.Maui.Controls.Cell.ContextActions"/> list property.</summary>
 		public bool HasContextActions
 		{
 			get { return _contextActions != null && _contextActions.Count > 0 && IsEnabled; }
@@ -107,7 +109,7 @@ public bool HasContextActions
 		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='IsContextActionsLegacyModeEnabled']/Docs/*" />
 		public bool IsContextActionsLegacyModeEnabled { get; set; } = false;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='Height']/Docs/*" />
+		/// <summary>Gets or sets the height of the Cell.</summary>
 		public double Height
 		{
 			get { return _height; }
@@ -124,14 +126,14 @@ public double Height
 			}
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='IsEnabled']/Docs/*" />
+		/// <summary>Gets or sets the IsEnabled state of the Cell. This is a bindable property.</summary>
 		public bool IsEnabled
 		{
 			get { return (bool)GetValue(IsEnabledProperty); }
 			set { SetValue(IsEnabledProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='RenderHeight']/Docs/*" />
+		/// <summary>Gets the height of the rendered cell on the device.</summary>
 		public double RenderHeight
 		{
 			get
@@ -157,7 +159,8 @@ public double RenderHeight
 		[EditorBrowsable(EditorBrowsableState.Never)]
 		public event EventHandler ForceUpdateSizeRequested;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='ForceUpdateSize']/Docs/*" />
+		/// <summary>Immediately updates the cell's size.</summary>
+		/// <remarks>Developers can call this method to update the cell's size, even if the cell is currently visible. Developers should note that this operation can be expensive.</remarks>
 		public void ForceUpdateSize()
 		{
 			if (_nextCallToForceUpdateSizeQueued)
@@ -221,7 +224,7 @@ protected override void OnPropertyChanging(string propertyName = null)
 			base.OnPropertyChanging(propertyName);
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='SendAppearing']/Docs/*" />
+		/// <summary>For internal use by the Microsoft.Maui.Controls platform.</summary>
 		[EditorBrowsable(EditorBrowsableState.Never)]
 		public void SendAppearing()
 		{
@@ -231,7 +234,7 @@ public void SendAppearing()
 			container?.SendCellAppearing(this);
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/Cell.xml" path="//Member[@MemberName='SendDisappearing']/Docs/*" />
+		/// <summary>For internal use by the Microsoft.Maui.Controls platform.</summary>
 		[EditorBrowsable(EditorBrowsableState.Never)]
 		public void SendDisappearing()
 		{

src/Controls/src/Core/Cells/EntryCell.cs

@@ -5,7 +5,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="Type[@FullName='Microsoft.Maui.Controls.EntryCell']/Docs/*" />
+	/// <summary>A <see cref="T:Microsoft.Maui.Controls.Cell"/> with a label and a single line text entry field.</summary>
 	public class EntryCell : Cell, ITextAlignmentElement, IEntryCellController, ITextAlignment
 	{
 		/// <summary>Bindable property for <see cref="Text"/>.</summary>
@@ -29,7 +29,7 @@ public class EntryCell : Cell, ITextAlignmentElement, IEntryCellController, ITex
 		/// <summary>Bindable property for <see cref="VerticalTextAlignment"/>.</summary>
 		public static readonly BindableProperty VerticalTextAlignmentProperty = TextAlignmentElement.VerticalTextAlignmentProperty;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='HorizontalTextAlignment']/Docs/*" />
+		/// <summary>Gets or sets the horizontal alignement of the Text property. This is a bindable property.</summary>
 		public TextAlignment HorizontalTextAlignment
 		{
 			get { return (TextAlignment)GetValue(TextAlignmentElement.HorizontalTextAlignmentProperty); }
@@ -43,36 +43,36 @@ public TextAlignment VerticalTextAlignment
 			set { SetValue(TextAlignmentElement.VerticalTextAlignmentProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='Keyboard']/Docs/*" />
+		/// <summary>Gets or sets the Keyboard to display while editing the EntryCell. This is a bindable property.</summary>
 		[System.ComponentModel.TypeConverter(typeof(Converters.KeyboardTypeConverter))]
 		public Keyboard Keyboard
 		{
 			get { return (Keyboard)GetValue(KeyboardProperty); }
 			set { SetValue(KeyboardProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='Label']/Docs/*" />
+		/// <summary>Gets or sets the fixed text presented next to the Entry in the EntryCell. This is a bindable property.</summary>
 		public string Label
 		{
 			get { return (string)GetValue(LabelProperty); }
 			set { SetValue(LabelProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='LabelColor']/Docs/*" />
+		/// <summary>Gets or sets the Color used for rendering the Label property. This is a bindable property.</summary>
 		public Color LabelColor
 		{
 			get { return (Color)GetValue(LabelColorProperty); }
 			set { SetValue(LabelColorProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='Placeholder']/Docs/*" />
+		/// <summary>Gets or sets the placeholder text displayed in the Entry when the Text is null or empty. This is a bindable property.</summary>
 		public string Placeholder
 		{
 			get { return (string)GetValue(PlaceholderProperty); }
 			set { SetValue(PlaceholderProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='Text']/Docs/*" />
+		/// <summary>Gets or sets the content of the Entry of the EntryCell. This is a bindable property.</summary>
 		public string Text
 		{
 			get { return (string)GetValue(TextProperty); }
@@ -81,7 +81,7 @@ public string Text
 
 		public event EventHandler Completed;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/EntryCell.xml" path="//Member[@MemberName='SendCompleted']/Docs/*" />
+		/// <summary>For internal use by the Microsoft.Maui.Controls platform.</summary>
 		[EditorBrowsable(EditorBrowsableState.Never)]
 		public void SendCompleted()
 			=> Completed?.Invoke(this, EventArgs.Empty);

src/Controls/src/Core/Cells/ImageCell.cs

@@ -3,15 +3,15 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../../docs/Microsoft.Maui.Controls/ImageCell.xml" path="Type[@FullName='Microsoft.Maui.Controls.ImageCell']/Docs/*" />
+	/// <summary>A <see cref="T:Microsoft.Maui.Controls.TextCell"/> that has an image.</summary>
 	public class ImageCell : TextCell
 	{
 		/// <summary>Bindable property for <see cref="ImageSource"/>.</summary>
 		public static readonly BindableProperty ImageSourceProperty = BindableProperty.Create(nameof(ImageSource), typeof(ImageSource), typeof(ImageCell), null,
 			propertyChanging: (bindable, oldvalue, newvalue) => ((ImageCell)bindable).OnSourcePropertyChanging((ImageSource)oldvalue, (ImageSource)newvalue),
 			propertyChanged: (bindable, oldvalue, newvalue) => ((ImageCell)bindable).OnSourcePropertyChanged((ImageSource)oldvalue, (ImageSource)newvalue));
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/ImageCell.xml" path="//Member[@MemberName='.ctor']/Docs/*" />
+		/// <summary>Initializes a new instance of the ImageCell class.</summary>
 		public ImageCell()
 		{
 			Disappearing += (sender, e) =>
@@ -22,7 +22,7 @@ public ImageCell()
 			};
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/ImageCell.xml" path="//Member[@MemberName='ImageSource']/Docs/*" />
+		/// <summary>Gets or sets the ImageSource from which the Image is loaded. This is a bindable property.</summary>
 		[System.ComponentModel.TypeConverter(typeof(ImageSourceConverter))]
 		public ImageSource ImageSource
 		{

src/Controls/src/Core/Cells/SwitchCell.cs

@@ -4,7 +4,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../../docs/Microsoft.Maui.Controls/SwitchCell.xml" path="Type[@FullName='Microsoft.Maui.Controls.SwitchCell']/Docs/*" />
+	/// <summary>A <see cref="T:Microsoft.Maui.Controls.Cell"/> with a label and an on/off switch.</summary>
 	public class SwitchCell : Cell
 	{
 		/// <summary>Bindable property for <see cref="On"/>.</summary>
@@ -27,14 +27,14 @@ public Color OnColor
 			set { SetValue(OnColorProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/SwitchCell.xml" path="//Member[@MemberName='On']/Docs/*" />
+		/// <summary>Gets or sets the state of the switch. This is a bindable property.</summary>
 		public bool On
 		{
 			get { return (bool)GetValue(OnProperty); }
 			set { SetValue(OnProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/SwitchCell.xml" path="//Member[@MemberName='Text']/Docs/*" />
+		/// <summary>Gets or sets the text displayed next to the switch. This is a bindable property.</summary>
 		public string Text
 		{
 			get { return (string)GetValue(TextProperty); }

src/Controls/src/Core/Cells/TextCell.cs

@@ -6,7 +6,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="Type[@FullName='Microsoft.Maui.Controls.TextCell']/Docs/*" />
+	/// <summary>A <see cref="T:Microsoft.Maui.Controls.Cell"/> with primary <see cref="P:Microsoft.Maui.Controls.TextCell.Text"/>  and <see cref="P:Microsoft.Maui.Controls.TextCell.Detail"/> text.</summary>
 	public class TextCell : Cell, ICommandElement
 	{
 		/// <summary>Bindable property for <see cref="Command"/>.</summary>
@@ -35,42 +35,45 @@ public class TextCell : Cell, ICommandElement
 		/// <summary>Bindable property for <see cref="DetailColor"/>.</summary>
 		public static readonly BindableProperty DetailColorProperty = BindableProperty.Create(nameof(DetailColor), typeof(Color), typeof(TextCell), null);
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='Command']/Docs/*" />
+		/// <summary>Gets or sets the ICommand to be executed when the TextCell is tapped. This is a bindable property.</summary>
+		/// <remarks>Setting the Command property has a side effect of changing the Enabled property depending on ICommand.CanExecute.</remarks>
 		public ICommand Command
 		{
 			get { return (ICommand)GetValue(CommandProperty); }
 			set { SetValue(CommandProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='CommandParameter']/Docs/*" />
+		/// <summary>Gets or sets the parameter passed when invoking the Command. This is a bindable property.</summary>
 		public object CommandParameter
 		{
 			get { return GetValue(CommandParameterProperty); }
 			set { SetValue(CommandParameterProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='Detail']/Docs/*" />
+		/// <summary>Gets or sets the secondary text to be displayed in the TextCell. This is a bindable property.</summary>
 		public string Detail
 		{
 			get { return (string)GetValue(DetailProperty); }
 			set { SetValue(DetailProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='DetailColor']/Docs/*" />
+		/// <summary>Gets or sets the color to render the secondary text. This is a bindable property.</summary>
+		/// <remarks>Not all platforms may support transparent text rendering. Using Color.Default will result in the system theme color being used.</remarks>
 		public Color DetailColor
 		{
 			get { return (Color)GetValue(DetailColorProperty); }
 			set { SetValue(DetailColorProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='Text']/Docs/*" />
+		/// <summary>Gets or sets the primary text to be displayed. This is a bindable property.</summary>
 		public string Text
 		{
 			get { return (string)GetValue(TextProperty); }
 			set { SetValue(TextProperty, value); }
 		}
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/TextCell.xml" path="//Member[@MemberName='TextColor']/Docs/*" />
+		/// <summary>Gets or sets the color to render the primary text. This is a bindable property.</summary>
+		/// <remarks>Not all platforms may support transparent text rendering. Using Color.Default will result in the system theme color being used. Color.Default is the default color value.</remarks>
 		public Color TextColor
 		{
 			get { return (Color)GetValue(TextColorProperty); }

src/Controls/src/Core/Cells/ViewCell.cs

@@ -4,13 +4,13 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../../docs/Microsoft.Maui.Controls/ViewCell.xml" path="Type[@FullName='Microsoft.Maui.Controls.ViewCell']/Docs/*" />
+	/// <summary>A <see cref="T:Microsoft.Maui.Controls.Cell"/> containing a developer-defined <see cref="T:Microsoft.Maui.Controls.View"/>.</summary>
 	[ContentProperty("View")]
 	public class ViewCell : Cell
 	{
 		View _view;
 
-		/// <include file="../../../docs/Microsoft.Maui.Controls/ViewCell.xml" path="//Member[@MemberName='View']/Docs/*" />
+		/// <summary>Gets or sets the View representing the content of the ViewCell.</summary>
 		public View View
 		{
 			get { return _view; }

src/Controls/src/Core/CheckBox/CheckedChangedEventArgs.cs

@@ -3,16 +3,17 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <include file="../../docs/Microsoft.Maui.Controls/CheckedChangedEventArgs.xml" path="Type[@FullName='Microsoft.Maui.Controls.CheckedChangedEventArgs']/Docs/*" />
+	/// <summary>Event Args for <see cref="T:Microsoft.Maui.Controls.CheckBox"/>'s <see cref="E:Microsoft.Maui.Controls.CheckBox.CheckedChanged"/> event.</summary>
 	public class CheckedChangedEventArgs : EventArgs
 	{
-		/// <include file="../../docs/Microsoft.Maui.Controls/CheckedChangedEventArgs.xml" path="//Member[@MemberName='.ctor']/Docs/*" />
+		/// <summary>Creates a new <see cref="T:Microsoft.Maui.Controls.CheckedChangedEventArgs"/> specifying whether the <see cref="T:Microsoft.Maui.Controls.CheckBox"/> is checked.</summary>
+		/// <param name="value">Boolean value indicating whether the <see cref="T:Microsoft.Maui.Controls.CheckBox"/> is checked.</param>
 		public CheckedChangedEventArgs(bool value)
 		{
 			Value = value;
 		}
 
-		/// <include file="../../docs/Microsoft.Maui.Controls/CheckedChangedEventArgs.xml" path="//Member[@MemberName='Value']/Docs/*" />
+		/// <summary>Boolean value indicating whether the <see cref="T:Microsoft.Maui.Controls.CheckBox"/> is checked.</summary>
 		public bool Value { get; private set; }
 	}
 }