From bb6f987b0274b1b781db78510825b8993e33e0e9 Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Sat, 3 May 2025 09:16:56 -0700
Subject: [PATCH] docs(fluid-form): improve docs

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

diff --git a/docs/src/pages/components/FluidForm.svx b/docs/src/pages/components/FluidForm.svx
index 68dbc604..d05f56d8 100644
--- a/docs/src/pages/components/FluidForm.svx
+++ b/docs/src/pages/components/FluidForm.svx
@@ -7,9 +7,15 @@
   import Preview from "../../components/Preview.svelte";
 </script>
 
+The `FluidForm` component provides a fluid-width form layout that adapts to its
+container. It's designed for full-width form layouts and works with most Carbon
+input components. Note that inline input variants cannot be used within a
+`FluidForm`.
+
 ## Fluid form
 
-Note that the `inline` input variants cannot be used within a `FluidForm`.
+Create a fluid-width form layout using the `FluidForm` component. This example
+shows a basic login form with required fields.
 
 <FluidForm>
   <TextInput labelText="User name" placeholder="Enter user name..." required />
@@ -23,4 +29,8 @@ Note that the `inline` input variants cannot be used within a `FluidForm`.
 
 ## Invalid state
 
+Handle form validation and display error states using the `invalid` and
+`invalidText` props on form inputs. This example demonstrates how to show
+validation errors in a fluid form.
+
 <FileSource src="/framed/FluidForm/FluidFormInvalid" />
\ No newline at end of file