注記 / ヒント / 警告

定義

本文に収まらない補足や、機能を壊したりセキュリティに影響したりする挙動を伝える、色付きの情報ボックス（aside）です。テキスト、画像、リスト、コードブロックを含められます。

Type: note または warning（背景色を決めます）

Aside の本文

（任意）タイトル / ヘッダー

注記の書式は注記とその他の表記タイプを参照してください。

本文に組み込めない有用な追加情報を読者に伝えるときは、注記を使います。

ユーザーのネットワークセキュリティに影響したり、機能を壊したりする挙動を伝えるときは、警告を使います。

Aside に多くの内容を入れないでください。 通常の本文の流れが途切れます。目安は、段落 3 つまで、または箇条書き 3 項目までです。それ以上必要な場合は、「重要な注意」などのドキュメントセクションを検討してください。
Aside は控えめに使います。 各セクションで、同じ種類の aside は 1 つまでにしてください。例外は、見出し直後に置く可用性の免責のみです。
手順のステップ内の aside にはヘッダーを付けないでください。 場所を取りすぎます。背景色だけで、通常の本文と区別できます。
機能の利用制限を示すときは note aside を使います（例: 「Enterprise プランのお客様のみ利用できます。」）。ページ先頭に、ヘッダーなしで置きます。