Add more xmldoc comments for AdornerLayer and AdornerDecorator

Author: michael-hawker

components/Adorners/src/AdornerDecorator.cs

@@ -13,23 +13,35 @@ public sealed partial class AdornerDecorator : Control
 {
     private const string PartAdornerLayer = "AdornerLayer";
 
+    /// <summary>
+    /// Gets or sets the single child element of the <see cref="AdornerDecorator"/>.
+    /// </summary>
     public UIElement Child
     {
         get { return (UIElement)GetValue(ContentProperty); }
         set { SetValue(ContentProperty, value); }
     }
 
-    // Using a DependencyProperty as the backing store for Content.  This enables animation, styling, binding, etc...
+    /// <summary>
+    /// Identifies the <see cref="Child"/> dependency property. 
+    /// </summary>
     public static readonly DependencyProperty ContentProperty =
         DependencyProperty.Register(nameof(Child), typeof(UIElement), typeof(AdornerDecorator), new PropertyMetadata(null));
 
-    public AdornerLayer? AdornerLayer { get; private set; }
+    /// <summary>
+    /// Gets the <see cref="AdornerLayer"/> contained within this <see cref="AdornerDecorator"/>.
+    /// </summary>
+    internal AdornerLayer? AdornerLayer { get; private set; }
 
+    /// <summary>
+    /// Constructs a new instance of <see cref="AdornerDecorator"/>.
+    /// </summary>
     public AdornerDecorator()
     {
         this.DefaultStyleKey = typeof(AdornerDecorator);
     }
 
+    /// <inheritdoc/>
     protected override void OnApplyTemplate()
     {
         base.OnApplyTemplate();

components/Adorners/src/AdornerLayer.cs

@@ -7,10 +7,18 @@
 namespace CommunityToolkit.WinUI;
 
 /// <summary>
-/// An adornment layer which can hold content to show on top of other components. If none is specified, one will be injected into your app content for you.
+/// An adornment layer which can hold content to show on top of other components.
+/// If none is specified, one will be injected into your app content for you.
+/// If a suitable location can't be automatically found, you can also use an
+/// <see cref="AdornerDecorator"/> to specify where the <see cref="AdornerLayer"/> should be placed.
 /// </summary>
 public partial class AdornerLayer : Canvas
 {
+    /// <summary>
+    /// Gets the <see cref="XamlProperty"/> of a <see cref="FrameworkElement"/>. Use this to retrieve any attached <see cref="UIElement"/> adorner from another <see cref="FrameworkElement"/>.
+    /// </summary>
+    /// <param name="obj">The <see cref="FrameworkElement"/> to retrieve the adorner from.</param>
+    /// <returns>The <see cref="UIElement"/> attached as an adorner.</returns>
     public static UIElement GetXaml(FrameworkElement obj)
     {
         return (UIElement)obj.GetValue(XamlProperty);
@@ -32,6 +40,9 @@ public static void SetXaml(FrameworkElement obj, UIElement value)
     public static readonly DependencyProperty XamlProperty =
         DependencyProperty.RegisterAttached("Xaml", typeof(UIElement), typeof(AdornerLayer), new PropertyMetadata(null, OnXamlPropertyChanged));
 
+    /// <summary>
+    /// Constructs a new instance of <see cref="AdornerLayer"/>.
+    /// </summary>
     public AdornerLayer()
     {
         SizeChanged += AdornerLayer_SizeChanged;
@@ -248,7 +259,9 @@ private static void RemoveAdorner(AdornerLayer layer, UIElement adorner)
         {
             layer.Children.Remove(border);
 
+#if !HAS_UNO
             VisualTreeHelper.DisconnectChildrenRecursive(border);
+#endif
         }
     }
 }

components/Adorners/src/Helpers/FrameworkElementExtensions.WaitUntilLoaded.cs

@@ -4,6 +4,9 @@
 
 namespace CommunityToolkit.WinUI.Future;
 
+/// <summary>
+/// Helper extensions for <see cref="FrameworkElement"/>.
+/// </summary>
 public static partial class FrameworkElementExtensions
 {
     /// <summary>