diff --git a/docs/contributing/pages/components.mdx b/docs/contributing/pages/components.mdx index 653761204b542..fc0f8840f941e 100644 --- a/docs/contributing/pages/components.mdx +++ b/docs/contributing/pages/components.mdx @@ -70,8 +70,11 @@ Attributes: - `title` (string) - optional - `level` (string: `'info' | 'warning' | 'success'`) - optional, defaults to `'info'` + **Where to place alerts:** -- Make sure your alerts aren't breaking the flow of the content. For example, don't put an alert in between two paragraphs that explain a single concept. Use alerts sparingly; too many alerts on a single page can be overwhelming. + +Make sure your alerts aren't breaking the flow of the content. For example, don't put an alert between two paragraphs that explain a single concept. Use alerts sparingly; too many alerts on a single page can be overwhelming. + **When to use which alert level:** - **Info**: Use this to emphasize information that users should read. For example: