From 6ddef20ef7847c05855b1ee3af8958a757ffc884 Mon Sep 17 00:00:00 2001
From: robloo <robloo@users.noreply.github.com>
Date: Sun, 7 May 2023 10:17:19 -0400
Subject: [PATCH] Improve comments

---
 .../ColorView/ColorView.Properties.cs                       | 6 ++++++
 src/Avalonia.Controls.ColorPicker/Helpers/Hsv.cs            | 2 +-
 src/Avalonia.Controls.ColorPicker/Helpers/Rgb.cs            | 2 +-
 3 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/Avalonia.Controls.ColorPicker/ColorView/ColorView.Properties.cs b/src/Avalonia.Controls.ColorPicker/ColorView/ColorView.Properties.cs
index 532e87a9fc..701dab97f7 100644
--- a/src/Avalonia.Controls.ColorPicker/ColorView/ColorView.Properties.cs
+++ b/src/Avalonia.Controls.ColorPicker/ColorView/ColorView.Properties.cs
@@ -504,6 +504,12 @@ namespace Avalonia.Controls
         /// <summary>
         /// Gets or sets the index of the selected tab/panel/page (subview).
         /// </summary>
+        /// <remarks>
+        /// When using the default control theme, this property is designed to be used with the
+        /// <see cref="ColorViewTab"/> enum. The <see cref="ColorViewTab"/> enum defines the
+        /// index values of each of the three standard tabs.
+        /// Use like `SelectedIndex = (int)ColorViewTab.Palette`.
+        /// </remarks>
         public int SelectedIndex
         {
             get => GetValue(SelectedIndexProperty);
diff --git a/src/Avalonia.Controls.ColorPicker/Helpers/Hsv.cs b/src/Avalonia.Controls.ColorPicker/Helpers/Hsv.cs
index 8a425b9581..76f33b3d83 100644
--- a/src/Avalonia.Controls.ColorPicker/Helpers/Hsv.cs
+++ b/src/Avalonia.Controls.ColorPicker/Helpers/Hsv.cs
@@ -11,7 +11,7 @@ namespace Avalonia.Controls.Primitives
     /// Contains and allows modification of Hue, Saturation and Value components.
     /// </summary>
     /// <remarks>
-    ///   The is a specialized struct optimized for permanence and memory:
+    ///   The is a specialized struct optimized for performance and memory:
     ///   <list type="bullet">
     ///     <item>This is not a read-only struct like <see cref="HsvColor"/> and allows editing the fields</item>
     ///     <item>Removes the alpha component unnecessary in core calculations</item>
diff --git a/src/Avalonia.Controls.ColorPicker/Helpers/Rgb.cs b/src/Avalonia.Controls.ColorPicker/Helpers/Rgb.cs
index 72e3821c2b..ee81a22ecf 100644
--- a/src/Avalonia.Controls.ColorPicker/Helpers/Rgb.cs
+++ b/src/Avalonia.Controls.ColorPicker/Helpers/Rgb.cs
@@ -12,7 +12,7 @@ namespace Avalonia.Controls.Primitives
     /// Contains and allows modification of Red, Green and Blue components.
     /// </summary>
     /// <remarks>
-    ///   The is a specialized struct optimized for permanence and memory:
+    ///   The is a specialized struct optimized for performance and memory:
     ///   <list type="bullet">
     ///     <item>This is not a read-only struct like <see cref="Color"/> and allows editing the fields</item>
     ///     <item>Removes the alpha component unnecessary in core calculations</item>