役立つ地図は情報を省く

鉄道の図は路線を直線化し、駅を等間隔に置くことで乗り換えを分かりやすくできます。同時に、歩けば近い2駅を遠く見せることもあります。乗る列車を選ぶのに役立つ抽象化が、徒歩経路を選ぶ人を迷わせるのです。

交通路線図の歴史は、模式図が経路選択以外の仕事にも使われたとき何が起きたかを問いかけます。ニューヨーク交通博物館の記述は、1972年の地図が路線を直線化し、地形の詳細をほぼ取り除いたことを確認しています。この話から、ある仕事に適した画像も別の仕事には補助図が必要だと分かります。提案された補助手段の制作史の細部までは、この教訓に必要ありません。

読者が探す経路を定める

どの図も情報を省きます。システム構成図は時間を、ワークフロー図はデータの値を、同期方向の地図は書き込みを許可できる人を省くかもしれません。省くからこそ読める場合が多いです。問題は省いた性質が読者の選択に必要なときに始まります。

箱2つと矢印1つの店舗とメールの同期図を想像します。「店舗 → メール基盤」です。「どちらが顧客記録を送るか」には答えられます。しかし同意も記録と一緒に移るか、重複をどう扱うか、購入時に送信待ちメッセージを取り消すかは分かりません。図が誤りなのではなく、それらの決定には不十分です。

描く前に、読者の問いを1文で書きます。

1. 駅 A

   出発
   接続
2. 乗り換え

   路線を変更
   接続
3. 駅 B

   目的地

「この項目はどこから来たか」には来歴が、「元システムが停止したらどうなるか」には時刻と障害状態が、「誰がキャンペーンを始められるか」には権限が必要です。1ページに複数の図を置けても、1つの図ですべての仕事に最適化したふりをすべきではありません。

図の種類	残す関係	よくあるゆがみ
模式的な路線図	接続と乗り換え	物理的な距離と方向
データフロー図	元、利用先、方向	時刻と権限
シーケンス図	呼び出しと応答の順序	長く続く状態と人の作業
権限表	許可される主体と行動	システム内での利用者の経路

これらは概念的な例であり、特定の製品や地図の評価ではありません。

使う場所で省略を示す

「縮尺は正確ではありません」という注は、旅行者が模式図を理解する助けになります。同期図なら「通常時のデータ方向を示します。書き込みについては障害経路と権限表を参照」と添えられます。欠けた決定を名指しするので、一般的な免責文より役立ちます。

補助図は結果の重さに応じて選びます。セキュリティ審査で使うなら権限は省けない文脈です。古い記録を調べるなら箱の位置より時刻と再試行状態が重要です。新しい連携の計画なら、項目の所有者と修正経路が実装を決めるかもしれません。

視覚的な整然さは落とし穴にもなります。交差のない矢印はきれいですが、戻りの経路を隠すかもしれません。同じ形の箱は同じ責任を連想させますが、実際には一方が正本で他方は破棄できる投影かもしれません。運用上の非対称性が重要なら、設計で見えるようにします。

必要な場所で次の図を示す

決定が必要になる場所で次の図を示せば、複数の読者に役立てられます。直近の問いに答える図から始め、近くに次の図へのリンクや切り替えを置きます。ラベルはそろえ、フローの「顧客」が権限表でも同じ対象だと分かるようにします。

有益な見直しでは、システムを知らない人に2つの決定をしてもらいます。最初は図の本来の用途で、次は省略された性質が必要な問いで試します。自信を持って誤った推論をするなら、省略を明示するか補助図が必要です。次に見る場所が分かるなら、抽象化は働いています。

データ所有に関するガイドは連携の根本的な選択を扱います。その地図は、完全そうな構成を眺めるためではなく、読者が正しい次の手順を選ぶためのものです。

図そのものに試験事例を入れられます。通常の記録と例外を1つずつ置き、両方をたどってもらいます。名前のない矢印のところで例外が消えるなら、図は決定を隠しています。経営向けの図は項目名を省けても、障害の担当者は示す必要があります。実装者向けの図はスキーマと再試行を示し、組織内の事情は省けます。問題は、それぞれの省略が目的を保っているかです。新しい読者が推測しなければならないなら、余白を箱で埋めるより、欠けた関係を加えるか補助図へ案内します。

地図は注意深く省くことで成功します。読者が決めたいことそのものを省くと失敗します。