diff --git a/preview/pages/segmented-control.astro b/preview/pages/segmented-control.astro
index 1b655facc..639a19ff0 100644
--- a/preview/pages/segmented-control.astro
+++ b/preview/pages/segmented-control.astro
@@ -16,7 +16,7 @@ import DocsLink from '@ui/DocsLink.astro'
Basic
- A list of items is enough for a plain control.
+ A nav-segmented with text nav-link items is enough for a plain control.
@@ -34,7 +34,7 @@ import DocsLink from '@ui/DocsLink.astro'
Icons only
- Pass icons without items for an icon-only control.
+ Put only an icon in each nav-link for an icon-only control.
@@ -43,7 +43,7 @@ import DocsLink from '@ui/DocsLink.astro'
With icons
- Combine items and icons to label each option.
+ Combine an icon and text in each nav-link to label each option.
@@ -52,7 +52,7 @@ import DocsLink from '@ui/DocsLink.astro'
Vertical
- Add vertical to stack the options in a column.
+ Add nav-segmented-vertical to stack the options in a column.
@@ -61,7 +61,7 @@ import DocsLink from '@ui/DocsLink.astro'
Vertical with disabled items
- Pass indexes to disabled to make specific options unselectable.
+ Add disabled to a nav-link to make that option unselectable.
@@ -88,7 +88,7 @@ import DocsLink from '@ui/DocsLink.astro'
Independent group
- Set a unique name so this control doesn't share selection state with others using the same items.
+ Use radio inputs with a unique name so this control doesn't share selection state with others using the same items.
@@ -97,7 +97,7 @@ import DocsLink from '@ui/DocsLink.astro'
Full width
- Add block to stretch the control across its container.
+ Add w-100 to stretch the control across its container.
@@ -118,7 +118,7 @@ import DocsLink from '@ui/DocsLink.astro'
Sizes
- Set size to sm or lg — with text, icons, or both.
+ Add nav-sm or nav-lg to change the size — with text, icons, or both.
diff --git a/preview/pages/stars-rating.astro b/preview/pages/stars-rating.astro
index c8b58c19f..3d4f85be4 100644
--- a/preview/pages/stars-rating.astro
+++ b/preview/pages/stars-rating.astro
@@ -25,7 +25,7 @@ import DocsLink from '@ui/DocsLink.astro'
Icons
- Swap the star for any icon with the icon prop.
+ Swap the star for any icon by passing a different SVG to the stars option.
@@ -39,7 +39,7 @@ import DocsLink from '@ui/DocsLink.astro'
Sizes
- Match the rating to surrounding text with size.
+ Match the rating to surrounding text with an icon-sm or icon-lg class on the star.
@@ -52,7 +52,7 @@ import DocsLink from '@ui/DocsLink.astro'
Colors
- Set color to any theme or extended color to match the rest of the page.
+ Color the star with a text-* class, any theme or extended color, to match the rest of the page.
diff --git a/preview/pages/tables.astro b/preview/pages/tables.astro
index 89f76c5b5..a9cbd91d8 100644
--- a/preview/pages/tables.astro
+++ b/preview/pages/tables.astro
@@ -35,7 +35,7 @@ import DocsLink from '@ui/DocsLink.astro'
Striped rows
- Alternate row shading with striped to make wide tables easier to scan.
+ Alternate row shading with table-striped to make wide tables easier to scan.
diff --git a/preview/pages/tags.astro b/preview/pages/tags.astro
index c7caea9e8..4556d6302 100644
--- a/preview/pages/tags.astro
+++ b/preview/pages/tags.astro
@@ -101,7 +101,7 @@ const colors = Object.values(siteData.colors) as { class: string; title: string
Selectable tags
- Add checkbox to let users toggle a tag on and off.
+ Add a tag-check checkbox to let users toggle a tag on and off.
{range(1, 6).map((i) => )}
{range(7, 12).map((i) => )}
@@ -114,7 +114,7 @@ const colors = Object.values(siteData.colors) as { class: string; title: string
Tags with badge
- Add a badge count to the end of the tag.
+ Add a tag-badge count to the end of the tag.
{range(1, 12).map((i) => )}