Blueberry
TOKYO, JAPAN Contact
← All termsGLOSSARY / Design

Annotation.

アノテーション

設計図や画面案に、意図・仕様・例外条件などの補足情報を付記すること。

UIの画面だけでは伝わらない操作条件、入力制約、エラー表示、文言のルールを明記する。例えば検索画面なら、空の状態、通信失敗、結果が多すぎる場合の挙動などを注釈として残すことで、開発や検証の曖昧さを減らせる。一方で、注釈が多すぎて全体を読み取れなくなれば逆効果になる。決定事項と検討中の仮説を分け、誰が何を確認すべきかを分かるようにする。図そのものより、関係者が同じ解釈で前に進めることに価値がある。仕様の根拠まで書き残しておくと、後の変更時に判断しやすくなる。「そう決まっている」だけでは、状況が変わったときに守るべき理由が分からない。