diff --git a/content/components/overlay.mdx b/content/components/overlay.mdx index d34826a90..232cdca09 100644 --- a/content/components/overlay.mdx +++ b/content/components/overlay.mdx @@ -14,7 +14,10 @@ import {AccessibilityLink} from '~/src/components/accessibility-link' ## Usage -Overlay is an internal component and is intended to be used as a private API, composing other components. It is not intended to be used on its own. + + ⚠️ Usage Warning ⚠️ + Overlay is an internal component and is intended to be used as a private API, composing other components. It is not intended to be used on its own. For a ready-to-use overlay-type component, consider Dialog, Select Panel, or Action Menu. + The overlay component handles all behaviors needed by overlay UIs as well as the common styles that all overlays should have. Overlay is the internal, or base component for many of our overlay-type components. Overlays use shadows to express elevation.