最近の検索
検索オプション
2.3. Admonitions
https://people.redhat.com/~jlaska/documentation-guide-en/s1-xml-admon.html
* Note は注目すべき追加情報を提示する。
* Tip は有益な情報や別の方法を提示する。
* Caution は特定の段階において注意を要することを示す。
* Important は見落とすべきでない情報を提示する。この情報はユーザの行動を変化させないかもしれないが、重要なものである。
* Warning は実行によって状態が変化しうる (たとえばファイルが削除されるなど) こと、それゆえそのような結果をよしとしない場合には実行すべきでないことを示す。
danger
https://tdg.docbook.org/tdg/5.2/danger#element.db.danger_refsection1
> In some types of documentation, the semantics of admonitions are clearly defined (`caution` might imply the possibility of harm to equipment whereas `warning` might imply harm to a person), but DocBook makes no such assertions.
caution は設備への被害の可能性を、 warning は人への被害の可能性を示すような使い方が例示されている。しかし DocBook 自体はそのような明確な意味論を規定しない。
https://search.toto.jp/%2Ftr%2FR063487N_200506.03.pdf
* 警告 (warning): 人が死亡、重傷を負う可能性、または火災の可能性が想定される
* 注意 (caution): 人が傷害を負う可能性および物的損害のみの発生が想定される
* お願い (notice): 安全に快適に使用するための情報
それはそれとして、直交して「禁止」「注意」「必ずおこなう」の3種類の分類がある。