From 96000cd2a98445a32683405345b1afc42a78329c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Henr=C3=A9=20Botha?= Date: Mon, 20 Oct 2025 12:00:23 +0200 Subject: [PATCH] Add common synonyms --- .../basic-writing-and-formatting-syntax.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index 3b131a3c533a..036f51fcff11 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -413,7 +413,7 @@ The footnote will render like this: ## Alerts -Alerts are a Markdown extension based on the blockquote syntax that you can use to emphasize critical information. On {% data variables.product.github %}, they are displayed with distinctive colors and icons to indicate the significance of the content. +Alerts are a Markdown extension based on the blockquote syntax that you can use to emphasize critical information. (They are also known as "callouts" or "admonitions".) On {% data variables.product.github %}, they are displayed with distinctive colors and icons to indicate the significance of the content. Use alerts only when they are crucial for user success and limit them to one or two per article to prevent overloading the reader. Additionally, you should avoid placing alerts consecutively. Alerts cannot be nested within other elements.