Callouts direct your attention to information of special importance or to information that doesn't fit smoothly into the main text. Consider your reader. If your doc has too many callouts, it might confuse your reader about what matters the most and distract them from what does.
Use your callouts judiciously. Recommendation: Skim the complete doc. If there are too many callouts, decide which ones can be removed.
Here's an example of the
<Callout variant="tip">Your tip text goes here.It can have multiple paragraphs.</Callout>
On our Docs site, we use these callout classes: