図
どうして図を使うのか?
文章(プログラム)では複数の要素に対する関係性が見づらい。
ほとんどの場合、階層構造かグラフ(節(ノード)と枝(エッジ))で表現することになる。
図はどう書かれるべきなのか?
取捨選択
必要な情報が書かれていて、不要な情報は書かれていない
概要と詳細のレベル
概要を書くべきところと詳細を書くべきところとを分ける
時系列の整理
時系列的にどういう順になっているのかを書く
上下関係
依存関係や階層構造などを書く
逆にわかりづらい図
そもそも目的が分からない。
要素が多すぎる。
多くの場合、詳細度を取り違えている。
説明不足
詳細度がバラバラ
説明不足と説明しすぎ
表現方法が不統一
標準的な記法と異なる図(独自記法)