better example

Author: mydea

docs/contributing/pages/components.mdx

@@ -8,13 +8,41 @@ sidebar_order: 40
 
 Render an alert callout.
 
-<Alert title="Important">
-This is an alert
+<Alert title="Watch out!">
+This is an info alert. Use these for information that's critical to know; it's important for users to read, but won't cause a catastrophic problem if they don't read it. These include versions that introduce breaking changes or feature limitations. Use infrequently.
 </Alert>
 
-```markdown {tabTitle:Example}
-<Alert title="Important">
-This is an alert
+<Alert level="warning" title="Important">
+This is a warning alert. Use these for items that MUST be well understood before proceeding. These highlight information that could cause users to make catastrophic errors that break their applications in ways that are very difficult to fix or create liabilities for them, such as information needed to avoid leaking PII. These should be used very rarely.
+</Alert>
+
+<Alert>
+This is an alert without title.
+</Alert>
+
+<Alert title="List">
+<ul>
+<li>Item 1</li>
+<li>Item 2</li>
+</ul>
+</Alert>
+
+
+```markdown {tabTitle:Info}
+<Alert title="Watch out!">
+This is an info alert.
+</Alert>
+```
+
+```markdown {tabTitle:Warning}
+<Alert level="warning" title="Important">
+This is a warning alert.
+</Alert>
+```
+
+```markdown {tabTitle:No Title}
+<Alert>
+This is an alert without title.
 </Alert>
 ```
 
@@ -30,7 +58,7 @@ Use this for these types of content:
 - **Warning:** Use these for items that MUST be well understood before proceeding. These highlight information that could cause users to make catastrophic errors that break their applications in ways that are very difficult to fix or create liabilities for them, such as information needed to avoid leaking PII. These should be used very rarely.
   - Use with the title "Important"; do not use the title "Warning"
 
-An Alert component with no level setting will render as a Note component.
+You can also omit the title of the alert.
 
 See also the [Note component](#note).