diff --git a/packages/braid-design-system/src/lib/components/Stack/Stack.docs.tsx b/packages/braid-design-system/src/lib/components/Stack/Stack.docs.tsx
index b082ed0a1d4..9f61207fad5 100644
--- a/packages/braid-design-system/src/lib/components/Stack/Stack.docs.tsx
+++ b/packages/braid-design-system/src/lib/components/Stack/Stack.docs.tsx
@@ -14,6 +14,12 @@ const docs: ComponentDocs = {
,
),
+ description: (
+
+ Defines the vertical rhythm of its child elements, interleaving a uniform
+ amount of space between each element.
+
+ ),
alternatives: [
{
name: 'Box',
diff --git a/packages/braid-design-system/src/lib/components/Stack/Stack.snippets.tsx b/packages/braid-design-system/src/lib/components/Stack/Stack.snippets.tsx
index e0910b87fd5..de8bc5e2cb1 100644
--- a/packages/braid-design-system/src/lib/components/Stack/Stack.snippets.tsx
+++ b/packages/braid-design-system/src/lib/components/Stack/Stack.snippets.tsx
@@ -1,76 +1,78 @@
import React from 'react';
import type { Snippets } from '../private/Snippets';
-import { Stack, Placeholder } from '../../playroom/components';
+import { Stack, Placeholder, Text, Heading } from '../../playroom/components';
import source from '@braid-design-system/source.macro';
export const snippets: Snippets = [
{
- name: 'XXSmall Space',
+ name: 'Small content',
code: source(
-
-
-
-
+
+ Small Text
+ Small Text
,
),
},
{
- name: 'XSmall Space',
+ name: 'Standard content',
code: source(
-
-
-
-
+
+ Standard Text
+ Standard Text
,
),
},
{
- name: 'Small Space',
+ name: 'Content groups',
code: source(
-
-
-
-
+
+ Heading
+ Standard Text
,
),
},
{
- name: 'Medium Space',
+ name: 'Content groups (loose)',
code: source(
-
-
-
-
+
+ Heading
+ Standard Text
,
),
},
{
- name: 'Gutter Space',
+ name: 'Section groups',
code: source(
-
-
+
,
),
},
{
- name: 'Large Space',
+ name: 'Section groups (loose)',
code: source(
-
-
+
,
),
},
{
- name: 'Responsive Space',
+ name: 'Page sections',
code: source(
-
-
-
-
+
+
+
+ ,
+ ),
+ },
+ {
+ name: 'Page sections (loose)',
+ code: source(
+
+
+
,
),
},