From ecb8e621c892451a56908941b92cc460d43f8992 Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Sun, 20 Apr 2025 15:02:51 -0700
Subject: [PATCH] docs(button-set): improve docs

---
 docs/src/pages/components/ButtonSet.svx | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/src/pages/components/ButtonSet.svx b/docs/src/pages/components/ButtonSet.svx
index 53fa39d8..4c66e526 100644
--- a/docs/src/pages/components/ButtonSet.svx
+++ b/docs/src/pages/components/ButtonSet.svx
@@ -4,9 +4,11 @@
   import Preview from "../../components/Preview.svelte";
 </script>
 
+Group related buttons together in a set. Use this component to create consistent spacing and alignment between multiple buttons.
+
 ## Default
 
-Buttons in a button set are juxtaposed by default.
+Place buttons side by side in a horizontal layout.
 
 <ButtonSet>
   <Button kind="secondary">Cancel</Button>
@@ -15,7 +17,7 @@ Buttons in a button set are juxtaposed by default.
 
 ## Stacked
 
-Set `stacked` to `true` to use the stacked variant.
+Set `stacked` to `true` to arrange buttons vertically.
 
 <ButtonSet stacked>
   <Button icon={Login}>Log in</Button>