From 42d6347dce31e317de83599220140542e463b445 Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Sat, 3 May 2025 10:37:30 -0700
Subject: [PATCH] docs(radio-tile): improve docs

---
 docs/src/pages/components/RadioTile.svx | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/src/pages/components/RadioTile.svx b/docs/src/pages/components/RadioTile.svx
index ff2d0c68..c3e4109f 100644
--- a/docs/src/pages/components/RadioTile.svx
+++ b/docs/src/pages/components/RadioTile.svx
@@ -7,8 +7,12 @@ components: ["TileGroup", "RadioTile"]
   import Preview from "../../components/Preview.svelte";
 </script>
 
+`RadioTile` provides a selectable tile interface for choosing a single option from a set. It supports both individual and grouped usage, with options for light and disabled states.
+
 ## Default
 
+Create a group of radio tiles with a shared name and legend.
+
 <TileGroup legend="Service pricing tiers" name="plan" selected="standard">
   <RadioTile value="lite">
     Lite plan
@@ -23,16 +27,20 @@ components: ["TileGroup", "RadioTile"]
 
 ## Reactive (one-way binding)
 
+Update the selected value using the `select` event.
+
 <FileSource src="/framed/RadioTile/RadioTileReactiveOneWay" />
 
 ## Reactive (two-way binding)
 
-Binding to the `selected` prop is a more concise approach to managing state.
+Bind to the `selected` prop for simpler state management.
 
 <FileSource src="/framed/RadioTile/RadioTileReactive" />
 
 ## Light variant
 
+Use the light variant for light backgrounds.
+
 <TileGroup legend="Service pricing tiers" name="plan-light" selected="standard">
   <RadioTile light value="lite">
     Lite plan
@@ -47,6 +55,8 @@ Binding to the `selected` prop is a more concise approach to managing state.
 
 ## Disabled state
 
+Disable specific tiles to prevent selection.
+
 <TileGroup legend="Service pricing tiers" name="plan-disabled" selected="standard">
   <RadioTile value="lite" disabled>
     Lite plan