専門的な情報を、立場の違う人に「分かるように説明する」のは難しいものです。このブログは「技術屋が説明書や提案書を分かりやすく書く」ために役に立つ情報をお届けします。

コピペの後で、違う部分を明示しよう

»

手順/仕様説明などをする際に 「Aの場合は・・・Bの場合は・・・」 のように基本は同じでも場合によって少し違う説明が必要なときがあります。

このような場合、 「コピペして違う部分だけ直す」  という方法をとりがちですが、それだけだと読者に大きな負担を与える、分かりにくい説明になりやすいので注意してください。

Labeling-basics-6-p1.PNG

先日20数人の図解宿題の添削をしていたところ、1/4の6人の解答でこのパターンを発見したぐらい、よくあるものなんです。これも自然な発想でしてしまうことなので、「やっちゃいけない」と教えられていないとなかなか気がつきません。

このやり方、書く方はコピペ+修正で済むので楽です。コピペした本人だからこそ、「修正した部分以外は同じ」と知っているので同じ部分をわざわざ読み比べたりはしません。ですが、それを知らない読者は「だいたい同じに見えるけれど、もしかしたら微妙に違うかもしれない」と不安になり、似た部分をいちいち全部見比べなければならないので、とても疲れてしまうわけです。書いた本人はこれに気がつきません。

Labeling-basics-6-p2.PNG

↓そんなわけですので、違う部分を目立たせるようにしましょう。

Labeling-basics-6-p3.PNG

↓「同じ情報を二度書かない」ようにするのも良い方法です。

Labeling-basics-6-p4.PNG

↓「標準的にはAだが、例外的にBとする場合がある」といった業務フローがある場合、標準側を真っ直ぐ、例外系を脇道として書くのが基本です。

Labeling-basics-6-p5.PNG

↓例外処理とバグはハッキリ区別しておくべきです。

Labeling-basics-6-p6.PNG

↓バグを注釈として書く方法。

Labeling-basics-6-p7.PNG

↓バグ発生後のフローを完全に切り離す方法。

Labeling-basics-6-p8.PNG

この記事は、筆者の公式サイト、「開米の図解思考ライブラリ」から転載しました。

Comment(0)

コメント

コメントを投稿する