Fix documentation issues - remove T: prefixes, fix generic types, replace "To be added", spell check

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

Author: 2 people

src/Controls/src/Core/AnimationExtensions.cs

@@ -34,7 +34,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>Extension methods for <see cref="T:Microsoft.Maui.Controls.IAnimatable"/> objects.</summary>
+	/// <summary>Extension methods for <see cref="Microsoft.Maui.Controls.IAnimatable"/> objects.</summary>
 	public static class AnimationExtensions
 	{
 		// We use a ConcurrentDictionary because Tweener relies on being able to remove
@@ -219,15 +219,15 @@ public static bool AnimationIsRunning(this IAnimatable self, string handle)
 		/// <param name="end">The fraction into the current animation at which to stop the animation.</param>
 		/// <param name="reverseVal">The inverse scale factor to use if <paramref name="reverse"/> is <see langword="true"/>.</param>
 		/// <param name="reverse">Whether to use the inverse scale factor in <paramref name="reverseVal"/> to deinterpolate.</param>
-		/// <returns>A function that performs a linear interpolation between <paramref name="start"/> and <paramref name="end"/>. Application developers can pass values between 0.0f and 1.0f to this function in order to recieve a value that is offset from <paramref name="start"/> or <paramref name="end"/>, depending on the value of <paramref name="reverse"/>, by the passed value times the distance between <paramref name="start"/> and <paramref name="end"/>.</returns>
+		/// <returns>A function that performs a linear interpolation between <paramref name="start"/> and <paramref name="end"/>. Application developers can pass values between 0.0f and 1.0f to this function in order to receive a value that is offset from <paramref name="start"/> or <paramref name="end"/>, depending on the value of <paramref name="reverse"/>, by the passed value times the distance between <paramref name="start"/> and <paramref name="end"/>.</returns>
 		/// <remarks>If <paramref name="reverse"/> is <see langword="true"/>, then the interpolation happens between <paramref name="start"/> and <paramref name="reverseVal"/>.</remarks>
 		public static Func<double, double> Interpolate(double start, double end = 1.0f, double reverseVal = 0.0f, bool reverse = false)
 		{
 			double target = reverse ? reverseVal : end;
 			return x => start + (target - start) * x;
 		}
 
-		/// <param name="self">To be added.</param>
+		/// <param name="self">The object instance.</param>
 		public static IDisposable Batch(this IAnimatable self) => new BatchObject(self);
 
 		static void AbortAnimation(AnimatableKey key)

src/Controls/src/Core/AppLinkEntry.cs

@@ -9,7 +9,7 @@ public class AppLinkEntry : Element, IAppLinkEntry
 	{
 		readonly Dictionary<string, string> keyValues;
 
-		/// <summary>Creates a new <see cref="T:Microsoft.Maui.Controls.AppLinkEntry"/> with default values.</summary>
+		/// <summary>Creates a new <see cref="Microsoft.Maui.Controls.AppLinkEntry"/> with default values.</summary>
 		public AppLinkEntry()
 		{
 			keyValues = new(StringComparer.Ordinal);
@@ -45,7 +45,7 @@ public string Description
 		}
 
 		/// <summary>Gets or sets a value that tells whether the item that is identified by the link entry is currently open.</summary>
-		/// <remarks>Application developers can set this value in <see cref="E:Microsoft.Maui.Controls.Application.PageAppearing"/> and <see cref="E:Microsoft.Maui.Controls.Application.PageDisappearing"/> methods to control whether the app link is shown for indexing or Handoff.</remarks>
+		/// <remarks>Application developers can set this value in <see cref="Microsoft.Maui.Controls.Application.PageAppearing"/> and <see cref="Microsoft.Maui.Controls.Application.PageDisappearing"/> methods to control whether the app link is shown for indexing or Handoff.</remarks>
 		public bool IsLinkActive
 		{
 			get { return (bool)GetValue(IsLinkActiveProperty); }
@@ -73,7 +73,7 @@ public string Title
 			set { SetValue(TitleProperty, value); }
 		}
 
-		/// <summary>Creates and returns a new <see cref="T:Microsoft.Maui.Controls.AppLinkEntry"/> for the specified <paramref name="uri"/>.</summary>
+		/// <summary>Creates and returns a new <see cref="Microsoft.Maui.Controls.AppLinkEntry"/> for the specified <paramref name="uri"/>.</summary>
 		/// <param name="uri">A URI that can be parsed by the target appliction to recreate a specific state.</param>
 		public static AppLinkEntry FromUri(Uri uri)
 		{
@@ -82,8 +82,8 @@ public static AppLinkEntry FromUri(Uri uri)
 			return appEntry;
 		}
 
-		/// <summary>Returns a string representation of this <see cref="T:Microsoft.Maui.Controls.AppLinkEntry"/>.</summary>
-		/// <returns>A  string representation of this <see cref="T:Microsoft.Maui.Controls.AppLinkEntry"/>.</returns>
+		/// <summary>Returns a string representation of this <see cref="Microsoft.Maui.Controls.AppLinkEntry"/>.</summary>
+		/// <returns>A  string representation of this <see cref="Microsoft.Maui.Controls.AppLinkEntry"/>.</returns>
 		public override string ToString()
 		{
 			return AppLinkUri.ToString();

src/Controls/src/Core/AppThemeChangedEventArgs.cs

@@ -7,7 +7,7 @@ namespace Microsoft.Maui.Controls
 	/// <include file="../../docs/Microsoft.Maui.Controls/AppThemeChangedEventArgs.xml" path="Type[@FullName='Microsoft.Maui.Controls.AppThemeChangedEventArgs']/Docs/*" />
 	public class AppThemeChangedEventArgs : EventArgs
 	{
-		/// <param name="appTheme">To be added.</param>
+		/// <param name="appTheme">The appTheme parameter.</param>
 		public AppThemeChangedEventArgs(AppTheme appTheme) =>
 			RequestedTheme = appTheme;
 

src/Controls/src/Core/AutomationProperties.cs

@@ -90,7 +90,7 @@ public static void SetExcludedWithChildren(BindableObject bindable, bool? value)
 			bindable.SetValue(ExcludedWithChildrenProperty, value);
 		}
 
-		/// <summary>Sets another element, such as a <see cref="T:Microsoft.Maui.Controls.Label"/> as the label for <paramref name="bindable"/>.</summary>
+		/// <summary>Sets another element, such as a <see cref="Microsoft.Maui.Controls.Label"/> as the label for <paramref name="bindable"/>.</summary>
 		/// <param name="bindable">The object whose label to set.</param>
 		/// <param name="value">The visual element that will name <paramref name="bindable"/>, or <see langword="null"/> to make <paramref name="bindable"/> its own label.</param>
 		public static void SetLabeledBy(BindableObject bindable, VisualElement value)

src/Controls/src/Core/BackButtonPressedEventArgs.cs

@@ -3,10 +3,10 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>Internal use only. Contains arguments for the event that is raised when a back button is pressed.</summary>
+	/// <summary>Internal API that may change or be removed without notice.</summary>
 	public class BackButtonPressedEventArgs : EventArgs
 	{
-		/// <summary>Internal use only. Gets or sets a value that indicates whether the back button event has already been handled.</summary>
+		/// <summary>Internal API that may change or be removed without notice.</summary>
 		public bool Handled { get; set; }
 	}
 }

src/Controls/src/Core/BindableObjectExtensions.cs

@@ -8,7 +8,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>Contains convenience extension methods for <see cref="T:Microsoft.Maui.Controls.BindableObject"/>.</summary>
+	/// <summary>Contains convenience extension methods for <see cref="Microsoft.Maui.Controls.BindableObject"/>.</summary>
 	public static class BindableObjectExtensions
 	{
 		internal static void RefreshPropertyValue(this BindableObject self, BindableProperty property, object value)
@@ -50,11 +50,11 @@ internal static void PropagateBindingContext<T>(this BindableObject self, IEnume
 		}
 
 		/// <summary>Creates and applies a binding to a property.</summary>
-		/// <param name="self">The <see cref="T:Microsoft.Maui.Controls.BindableObject"/>.</param>
+		/// <param name="self">The <see cref="Microsoft.Maui.Controls.BindableObject"/>.</param>
 		/// <param name="targetProperty">The BindableProperty on which to set a binding.</param>
-		/// <param name="path">A <see cref="T:System.String"/> indicating the property path to bind to.</param>
-		/// <param name="mode">The <see cref="T:Microsoft.Maui.Controls.BindingMode"/> for the binding. This parameter is optional. Default is <see cref="F:Microsoft.Maui.Controls.BindingMode.Default"/>.</param>
-		/// <param name="converter">An <see cref="T:Microsoft.Maui.Controls.IValueConverter"/> for the binding. This parameter is optional. Default is <see langword="null"/>.</param>
+		/// <param name="path">A <see cref="System.String"/> indicating the property path to bind to.</param>
+		/// <param name="mode">The <see cref="Microsoft.Maui.Controls.BindingMode"/> for the binding. This parameter is optional. Default is <see cref="Microsoft.Maui.Controls.BindingMode.Default"/>.</param>
+		/// <param name="converter">An <see cref="Microsoft.Maui.Controls.IValueConverter"/> for the binding. This parameter is optional. Default is <see langword="null"/>.</param>
 		/// <param name="stringFormat">A string used as stringFormat for the binding. This parameter is optional. Default is <see langword="null"/>.</param>
 		/// <remarks>The following example shows how to use the extension method to set a binding.</remarks>
 		[RequiresUnreferencedCode(TrimmerConstants.StringPathBindingWarning, Url = TrimmerConstants.ExpressionBasedBindingsDocsUrl)]
@@ -122,10 +122,10 @@ public static void SetBinding(this BindableObject self, BindableProperty targetP
 		/// </remarks>
 		/// <typeparam name="TSource">The source type.</typeparam>
 		/// <typeparam name="TProperty">The property type.</typeparam>
-		/// <param name="self">The <see cref="T:Microsoft.Maui.Controls.BindableObject" />.</param>
-		/// <param name="targetProperty">The <see cref="T:Microsoft.Maui.Controls.BindableProperty" /> on which to set a binding.</param>
+		/// <param name="self">The <see cref="Microsoft.Maui.Controls.BindableObject"/>.</param>
+		/// <param name="targetProperty">The <see cref="Microsoft.Maui.Controls.BindableProperty"/> on which to set a binding.</param>
 		/// <param name="getter">An getter method used to retrieve the source property.</param>
-		/// <param name="mode">The binding mode. This property is optional. Default is <see cref="F:Microsoft.Maui.Controls.BindingMode.Default" />.</param>
+		/// <param name="mode">The binding mode. This property is optional. Default is <see cref="Microsoft.Maui.Controls.BindingMode.Default"/>.</param>
 		/// <param name="converter">The converter. This parameter is optional. Default is <see langword="null" />.</param>
 		/// <param name="converterParameter">An user-defined parameter to pass to the converter. This parameter is optional. Default is <see langword="null" />.</param>
 		/// <param name="stringFormat">A String format. This parameter is optional. Default is <see langword="null" />.</param>
@@ -218,10 +218,10 @@ internal static bool TrySetAppTheme(
 
 		public static void SetAppTheme<T>(this BindableObject self, BindableProperty targetProperty, T light, T dark) => self.SetBinding(targetProperty, new AppThemeBinding { Light = light, Dark = dark });
 
-		/// <param name="self">To be added.</param>
-		/// <param name="targetProperty">To be added.</param>
-		/// <param name="light">To be added.</param>
-		/// <param name="dark">To be added.</param>
+		/// <param name="self">The object instance.</param>
+		/// <param name="targetProperty">The targetProperty parameter.</param>
+		/// <param name="light">The light parameter.</param>
+		/// <param name="dark">The dark parameter.</param>
 		public static void SetAppThemeColor(this BindableObject self, BindableProperty targetProperty, Color light, Color dark)
 			=> SetAppTheme(self, targetProperty, light, dark);
 	}

src/Controls/src/Core/BindableProperty.cs

@@ -12,7 +12,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>A BindableProperty is a backing store for properties allowing bindings on <see cref="T:Microsoft.Maui.Controls.BindableObject"/>.</summary>
+	/// <summary>A BindableProperty is a backing store for properties allowing bindings on <see cref="Microsoft.Maui.Controls.BindableObject"/>.</summary>
 	[DebuggerDisplay("{PropertyName}")]
 	[System.ComponentModel.TypeConverter(typeof(BindablePropertyConverter))]
 	public sealed class BindableProperty

src/Controls/src/Core/BoundsConstraint.cs

@@ -7,7 +7,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>A bounds layout constraint used by <see cref="T:Microsoft.Maui.Controls.Compatibility.RelativeLayout"/>s.</summary>
+	/// <summary>A bounds layout constraint used by <see cref="Microsoft.Maui.Controls.Compatibility.RelativeLayout"/>s.</summary>
 	public class BoundsConstraint
 	{
 		Func<Rect> _measureFunc;
@@ -19,7 +19,7 @@ public class BoundsConstraint
 		internal bool CreatedFromExpression { get; set; }
 		internal IEnumerable<View> RelativeTo { get; set; }
 
-		/// <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>
+		/// <summary>Returns a <see cref="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)

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

@@ -10,7 +10,7 @@
 namespace Microsoft.Maui.Controls
 {
 	// Don't add IElementConfiguration<Cell> because it kills performance on UWP structures that use Cells
-	/// <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>
+	/// <summary>Provides base class and capabilities for all Microsoft.Maui.Controls cells. Cells are elements meant to be added to <see cref="Microsoft.Maui.Controls.ListView"/> or <see cref="Microsoft.Maui.Controls.TableView"/>.</summary>
 	public abstract class Cell : Element, ICellController, IFlowDirectionController, IPropertyPropagationController, IVisualController, IWindowController, IVisualTreeElement
 	{
 		/// <summary>The default height of cells.</summary>
@@ -100,7 +100,7 @@ public IList<MenuItem> ContextActions
 			}
 		}
 
-		/// <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>
+		/// <summary>Gets a value that indicates whether the cell has at least one menu item in its <see cref="Microsoft.Maui.Controls.Cell.ContextActions"/> list property.</summary>
 		public bool HasContextActions
 		{
 			get { return _contextActions != null && _contextActions.Count > 0 && IsEnabled; }

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

@@ -5,7 +5,7 @@
 
 namespace Microsoft.Maui.Controls
 {
-	/// <summary>A <see cref="T:Microsoft.Maui.Controls.Cell"/> with a label and a single line text entry field.</summary>
+	/// <summary>A <see cref="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>