Fix Alerts example, and copyedit intro of using-markdown-and-liquid-i…

…n-github-docs.md (#36266)
github · Feb 12, 2025 · 0d6108f · 0d6108f
1 parent ae41043
commit 0d6108f
Showing 1 changed file with 6 additions and 4 deletions.
diff --git a/...ontributing/writing-for-github-docs/using-markdown-and-liquid-in-github-docs.md b/...ontributing/writing-for-github-docs/using-markdown-and-liquid-in-github-docs.md
@@ -50,14 +50,13 @@ This content is displayed on the {% data variables.product.prodname_docs %} site
 
 ## Alerts
 
-Alerts highlight important information that users need to know. We use standard formatting and colors for four different types of Alerts: Note, Tip, Warning, and Caution.
-
-For information on when to use alerts, and how to format them in Markdown, see [AUTOTITLE](/contributing/style-guide-and-content-model/style-guide#alerts).
+Alerts highlight important information that users need to know. For details about supported alert types, how to format them in Markdown, and information on when to use alerts, see [AUTOTITLE](/contributing/style-guide-and-content-model/style-guide#alerts).
 
 ### Examples of alerts
 
 ```markdown
-> [!NOTE] Keep this in mind.
+> [!TIP]
+> Try this out!
 ```
 
 ```markdown
@@ -69,6 +68,9 @@ For information on when to use alerts, and how to format them in Markdown, see [
 
 ### Example alerts rendered on {% data variables.product.prodname_docs %}
 
+> [!TIP]
+> Try this out!
+
 > [!NOTE]
 > Generally alerts should be short.
 >