diff --git a/docs/src/pages/components/ButtonSet.svx b/docs/src/pages/components/ButtonSet.svx
index 702d154c..bf4646a3 100644
--- a/docs/src/pages/components/ButtonSet.svx
+++ b/docs/src/pages/components/ButtonSet.svx
@@ -8,7 +8,9 @@ source: Button/ButtonSet.svelte
   import Preview from "../../components/Preview.svelte";
 </script>
 
-### Default (juxtaposed)
+### Default
+
+Buttons in a button set are juxtaposed by default.
 
 <ButtonSet>
   <Button kind="secondary">Cancel</Button>
@@ -17,6 +19,8 @@ source: Button/ButtonSet.svelte
 
 ### Stacked
 
+Set `stacked` to `true` to use the stacked variant.
+
 <ButtonSet stacked>
   <Button icon={Login16}>Log in</Button>
   <Button kind="ghost">Sign up</Button>