diff --git a/docs/components/alert.md b/docs/components/alert.md
index 4c4c772cb..14238a824 100644
--- a/docs/components/alert.md
+++ b/docs/components/alert.md
@@ -8,12 +8,8 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor i
 
 ```html preview
 <sl-alert type="primary" open>
-  Nothing fancy here, just a simple alert.
-</sl-alert>
-<br>
-<sl-alert type="primary" open closable>
   <sl-icon slot="icon" name="info-circle"></sl-icon>
-  This one is a bit fancier because now it has an icon and is closable.
+  This is a standard alert. You can customize its content and even the icon.
 </sl-alert>
 ```
 
@@ -24,33 +20,58 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor i
 ### Types
 
 ```html preview
-<sl-alert type="primary" open closable>
+<sl-alert type="primary" open>
   <sl-icon slot="icon" name="info-circle"></sl-icon>
-  <strong>Your changes have been saved</strong><br>
-  You can continue working or safely leave the app now.
+  <strong>This is super informative</strong><br>
+  You can tell by how pretty the alert is.
 </sl-alert>
+
 <br>
-<sl-alert type="success" open closable>
+
+<sl-alert type="success" open>
   <sl-icon slot="icon" name="check2-circle"></sl-icon>
   <strong>Your changes have been saved</strong><br>
-  You can continue working or safely leave the app now.
+  You can safely exit the app now.
 </sl-alert>
+
 <br>
-<sl-alert type="info" open closable>
+
+<sl-alert type="info" open>
   <sl-icon slot="icon" name="gear"></sl-icon>
-  <strong>Your changes have been saved</strong><br>
-  You can continue working or safely leave the app now.
+  <strong>Your settings have been updated</strong><br>
+  Some settings will take affect the next time you log in.
 </sl-alert>
+
 <br>
-<sl-alert type="warning" open closable>
+
+<sl-alert type="warning" open>
   <sl-icon slot="icon" name="exclamation-triangle"></sl-icon>
-  <strong>Your changes have been saved</strong><br>
-  You can continue working or safely leave the app now.
+  <strong>This will end your session</strong><br>
+  You will be logged out until you log in again.
 </sl-alert>
+
 <br>
-<sl-alert type="danger" open closable>
+
+<sl-alert type="danger" open>
   <sl-icon slot="icon" name="exclamation-octagon"></sl-icon>
-  <strong>Your changes have been saved</strong><br>
-  You can continue working or safely leave the app now.
+  <strong>Delete this file?</strong><br>
+  This is permanent, which means forever!
 </sl-alert>
-```
\ No newline at end of file
+```
+
+### Closable
+
+```html preview
+<sl-alert type="primary" open closable>
+  <sl-icon slot="icon" name="info-circle"></sl-icon>
+  You can close this alert any time!
+</sl-alert>
+```
+
+### Without Icon
+
+```html preview
+<sl-alert type="primary" open>
+  Nothing fancy here, just a simple alert.
+</sl-alert>
+```