| Do | Keep content supplementary — hover cards should enhance understanding without blocking the primary workflow. |
| Do | Provide a dashed underline on text triggers so users know the element is hoverable. |
| Do | Use the hook API (useXDSHoverCard) when you need more control over timing or placement. |
| Don't | Place critical actions or required information inside a hover card — users may miss content that only appears on hover. |
| Don't | Use a hover card when a simple Tooltip or Popover would suffice. |
| Don't | Use a HoverCard for content the user must interact with — it disappears when the cursor leaves. |