diff --git a/src/pages/blocks/inline-alert/index.md b/src/pages/blocks/inline-alert/index.md
index e0e6d7b..e8724b4 100644
--- a/src/pages/blocks/inline-alert/index.md
+++ b/src/pages/blocks/inline-alert/index.md
@@ -18,16 +18,17 @@ Your alert message here.
 ## Parameters
 
 - **slots**: 
-  - `"text"` - Simple text
-  - `"header, text1, text2"` - With header and sections
-
-- **variant**: Alert type (default: `info`)
-  - `"info"` - Blue
-  - `"help"` - Purple
-  - `"warning"` - Orange
-  - `"error"` - Red
-  - `"success"` - Green
-  - `"neutral"` - Gray
+  - `heading` (optional) - Use plain markdown text. You can only use one title per alert block.
+  - `"text"` (required). Use plain markdown text.
+  - `text1, text2, text[n]` - You can use additional text slots to display multiple paragraphs.
+
+- **variant**: determines the icon and border color of the alert
+  - `info` (default) — use to add helpful information.
+  - `"help"` - use to add brief steps from or links to other help topics.
+  - `"error"` - use to highlight errors that may result from an action.
+  - `"success"` - use to highlight success messages that may be displayed after an action.
+  - `"warning"` - use to focus attention on a potential problem that could occur.
+  - `"neutral"` - use as an all-purpose callout that displays a black border and no icon.
 
 ## Examples
 
@@ -37,11 +38,11 @@ Your alert message here.
 
 This is an info alert.
 
-### Warning
+### Help
 
-<InlineAlert slots="text" variant="warning"/>
+<InlineAlert slots="text" variant="help"/>
 
-This is a warning alert.
+This is an help alert.
 
 ### Error
 
@@ -54,3 +55,40 @@ This is an error alert.
 <InlineAlert slots="text" variant="success"/>
 
 This is a success alert.
+
+### Warning
+
+<InlineAlert slots="text" variant="warning"/>
+
+This is a warning alert.
+
+### Neutral
+
+<InlineAlert slots="text" variant="neutral"/>
+
+This is a neutral alert.
+
+### Richer Inline Alert
+
+<InlineAlert variant="help" slots="heading, text1, text2, text3, text4" />
+
+Alternative steps:
+
+**Step 1:** This is faux step text for the `text1` slot.
+This is faux step text for the `text1` slot.
+This is faux step text for the `text1` slot.
+This is faux step text for the `text1` slot.
+This is faux step text for the `text1` slot.
+
+**Step 2:** This is faux step text for the `text2` slot.
+This is faux step text for the `text2` slot.
+This is faux step text for the `text2` slot.
+
+**Step 3:** This is faux step text for the `text3` slot.
+
+**Step 4:** This is faux step text for the `text4` slot.
+This is faux step text for the `text3` slot.
+
+
+
+