From 51988f63d5eabc0f4461b5aa2a71495452d54ab1 Mon Sep 17 00:00:00 2001
From: Nate Butler <iamnbutler@gmail.com>
Date: Tue, 9 Jan 2024 14:50:04 -0500
Subject: [PATCH] Document more enums

---
 crates/ui/src/components/button/button_like.rs | 4 ++--
 crates/ui/src/components/divider.rs            | 1 +
 crates/ui/src/styled_ext.rs                    | 7 ++++---
 crates/ui/src/styles/color.rs                  | 1 +
 crates/ui/src/styles/elevation.rs              | 1 +
 crates/ui/src/styles/typography.rs             | 1 +
 6 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/crates/ui/src/components/button/button_like.rs b/crates/ui/src/components/button/button_like.rs
index d6ecad41fc657860ba31622810e8459cb4a72072..2c292595c751c136b4c83b4832f5b49dda81c17a 100644
--- a/crates/ui/src/components/button/button_like.rs
+++ b/crates/ui/src/components/button/button_like.rs
@@ -95,6 +95,7 @@ impl From<ButtonStyle> for Color {
     }
 }
 
+/// Sets the visual appearance of a button.
 #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Copy, Default)]
 pub enum ButtonStyle {
     /// A filled button with a solid background color. Provides emphasis versus
@@ -262,8 +263,7 @@ impl ButtonStyle {
     }
 }
 
-/// ButtonSize can also be used to help build  non-button elements
-/// that are consistently sized with buttons.
+/// Sets the height of a button. Can also be used to size  non-button elements to align with [Button]s.
 #[derive(Default, PartialEq, Clone, Copy)]
 pub enum ButtonSize {
     Large,
diff --git a/crates/ui/src/components/divider.rs b/crates/ui/src/components/divider.rs
index 2567c3fc3476c72819f0d30f5eae2a3e74f68059..dfe31b677ba6fb8b1d4a2878b97a9ad947856cac 100644
--- a/crates/ui/src/components/divider.rs
+++ b/crates/ui/src/components/divider.rs
@@ -7,6 +7,7 @@ enum DividerDirection {
     Vertical,
 }
 
+/// Sets the color of a [Divider].
 #[derive(Default)]
 pub enum DividerColor {
     Border,
diff --git a/crates/ui/src/styled_ext.rs b/crates/ui/src/styled_ext.rs
index 8c5da763f360621a5a4a1d77ada46c56a6a05992..1f47fe4f140cfc0e0766ecf5a028c382a8d22b73 100644
--- a/crates/ui/src/styled_ext.rs
+++ b/crates/ui/src/styled_ext.rs
@@ -30,6 +30,7 @@ pub trait StyledExt: Styled + Sized {
         self.flex().flex_col()
     }
 
+    /// Sets the text size using a [UiTextSize].
     fn text_ui_size(self, size: UiTextSize) -> Self {
         self.text_size(size.rems())
     }
@@ -40,7 +41,7 @@ pub trait StyledExt: Styled + Sized {
     ///
     /// Note: The absolute size of this text will change based on a user's `ui_scale` setting.
     ///
-    /// Use [`text_ui_sm`] for regular-sized text.
+    /// Use `text_ui_sm` for smaller text.
     fn text_ui(self) -> Self {
         self.text_size(UiTextSize::default().rems())
     }
@@ -51,7 +52,7 @@ pub trait StyledExt: Styled + Sized {
     ///
     /// Note: The absolute size of this text will change based on a user's `ui_scale` setting.
     ///
-    /// Use [`text_ui`] for regular-sized text.
+    /// Use `text_ui` for regular-sized text.
     fn text_ui_sm(self) -> Self {
         self.text_size(UiTextSize::Small.rems())
     }
@@ -62,7 +63,7 @@ pub trait StyledExt: Styled + Sized {
     ///
     /// Note: The absolute size of this text will change based on a user's `ui_scale` setting.
     ///
-    /// Use [`text_ui`] for regular-sized text.
+    /// Use `text_ui` for regular-sized text.
     fn text_ui_xs(self) -> Self {
         self.text_size(UiTextSize::XSmall.rems())
     }
diff --git a/crates/ui/src/styles/color.rs b/crates/ui/src/styles/color.rs
index 977a26dedce61d20bb27ee6b65bcc9f3f8738096..434183e5606135cdcb7e420c023c1108d0aa0a42 100644
--- a/crates/ui/src/styles/color.rs
+++ b/crates/ui/src/styles/color.rs
@@ -1,6 +1,7 @@
 use gpui::{Hsla, WindowContext};
 use theme::ActiveTheme;
 
+/// Sets a color that has a consistent meaning across all themes.
 #[derive(Debug, Default, PartialEq, Copy, Clone)]
 pub enum Color {
     #[default]
diff --git a/crates/ui/src/styles/elevation.rs b/crates/ui/src/styles/elevation.rs
index 7b3835c2e54b3e60528ab212311d245dfd7223d3..055a419e072afa959e12fe2d2f5b4942b34679a1 100644
--- a/crates/ui/src/styles/elevation.rs
+++ b/crates/ui/src/styles/elevation.rs
@@ -85,6 +85,7 @@ impl LayerIndex {
     }
 }
 
+/// Sets ann appropriate z-index for the given layer based on it's intended useage.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum ElementIndex {
     Effect,
diff --git a/crates/ui/src/styles/typography.rs b/crates/ui/src/styles/typography.rs
index 39937ebff1701f2195c4112235c919368b97b364..20f5e5f48f3815559d3ba48cdbe27ea6d242ebfb 100644
--- a/crates/ui/src/styles/typography.rs
+++ b/crates/ui/src/styles/typography.rs
@@ -38,6 +38,7 @@ impl UiTextSize {
     }
 }
 
+/// Sets the size of a [Headline] element
 #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Copy, Default)]
 pub enum HeadlineSize {
     XSmall,