From d9e45e98257658616264957c05e6f85efe38a1db Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Sun, 20 Apr 2025 15:06:16 -0700
Subject: [PATCH] docs(clickable-tile): improve docs

---
 docs/src/pages/components/ClickableTile.svx | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/src/pages/components/ClickableTile.svx b/docs/src/pages/components/ClickableTile.svx
index e6ec3bf3..58852fdf 100644
--- a/docs/src/pages/components/ClickableTile.svx
+++ b/docs/src/pages/components/ClickableTile.svx
@@ -3,15 +3,19 @@
   import Preview from "../../components/Preview.svelte";
 </script>
 
+Clickable tiles create interactive content areas that link to other pages or trigger actions. Use them to group related content and provide clear navigation targets.
+
 ## Default
 
+Create a clickable tile with an `href` to link to another page.
+
 <ClickableTile href="https://www.carbondesignsystem.com/">
 Carbon Design System
 </ClickableTile>
 
 ## Prevent default behavior
 
-Use the forwarded `click` event and invoke `e.preventDefault()` to prevent the native link behavior.
+Handle the `click` event to override the default link behavior. Use `e.preventDefault()` to stop navigation.
 
 <ClickableTile
   href="/"
@@ -25,12 +29,16 @@ Use the forwarded `click` event and invoke `e.preventDefault()` to prevent the n
 
 ## Light variant
 
+Set `light` to `true` to use the light color scheme.
+
 <ClickableTile light href="https://www.carbondesignsystem.com/">
 Carbon Design System
 </ClickableTile>
 
 ## Disabled state
 
+Set `disabled` to `true` to prevent interaction.
+
 <ClickableTile disabled href="https://www.carbondesignsystem.com/">
 Carbon Design System
 </ClickableTile>