Admonishments are notes or alerts that are separated from the main body of text. Use notes and other admonishments sparingly because they can disrupt the flow of text and even come across as an afterthought. Carefully consider whether a note or admonishment adds value before adding it.
You can use the following types of notes and alerts:
You can use notes and other admonishments in text and tables. You can add an admonishment in the conceptual information of a task topic. However, avoid using admonishments in steps because they can disrupt the flow of the procedure and make it difficult for users to follow the steps.
