Description

According to Single Sourcing - Building Modular Documentation (Kurt Ament) authors should stick to the industry standard of using note, tip, warning, and caution boxes.

The note box is used as follows:

Neutral or positive clarification that applies only in special cases, or that qualifies important points.

Kurt Ament. Single Sourcing - Building Modular Documentation. 2003

Properties

The macro provides the following properties for configuration.

Title

The title is an optional parameter.

Here is an example with title:

Show Icon

The checkbox allows to remove the icon from the box.

Related macros

Here is a list of alternative boxes to use for your texts: