Informative vs. helpful content

The content within the contextual help's popover reflects the icon it's associated with: either the info icon or the help icon.

Use the info icon for informative content: specific, brief, and contextual guidance. This is best for supplemental or nice-to-know information, in-line with a label or a component (if there is no label). The content should be instructive in tone.

Use the help icon for helpful content: more detailed, in-depth guidance about a task, UI element, tool, or keyboard shortcuts. This may include an image, video, or link and should be helpful in tone.

Use proper formatting

For this component, don't add a period to the end of the title. A question mark is acceptable, depending on the context.

For the description, add a period to the end of the sentence, even if it's only a single sentence.

If using a standalone link, do not add punctuation to the end of the link text.

If using a standalone link, make sure that the landing experience is intuitive, helpful, and naturally builds upon the information being introduced in the component. For example, don't link to an external sales website unless the information there is directly related to a user being able to do something within the product.

A generic "Learn more" can be acceptable, but it's more helpful to include another word or two in the link text that gives more context about the landing experience.