誠ブログは2015年4月6日に「オルタナティブ・ブログ」になりました。
各ブロガーの新規エントリーは「オルタナティブ・ブログ」でご覧ください。

ラベル付き箇条書き例題:Dogtailの紹介スライド

ラベル付き箇条書き例題:Dogtailの紹介スライド

開米 瑞浩

IT技術者経験をバックグラウンドに、技術系の専門的な情報を「分かりやすく書く」スキルの指導を得意とするドキュメント・コンサルタント。技術者向け文書作成研修経験多数。

当ブログ「技術屋のためのドキュメント相談所」は、2015年4月6日から新しいURL「​http://blogs.itmedia.co.jp/doc-consul/」 に移動しました。引き続きご愛読ください。


こんにちは。技術屋のためのドキュメント相談所長の開米です。

数年前のある日のこと、相談者Aさんから、「開米さん、ちょっとこれを見て欲しいんですが・・・」

と、こんな文書をいただきました。

Dogtail-2.jpg

Dogtail-3.jpg

開米 :これは何に使う文書ですか?
Aさん:社内の勉強会で技術紹介をするための資料です
開米 :で、これを・・・・
Aさん:いつも、お前の発表はわかりにくいと言われてしまうんです。何か改善のヒントはありませんか?

ということで、考えてみました。

簡単なプレゼンをするとき、「箇条書き」はよく使われる方法ですが、この例の場合は「ラベル付き箇条書き」のほうが良さそうです

Aさん:「ラベル付き箇条書き」と言うのはなんですか?
開米 :たとえばこういうことです

Dogtail-4.jpg


Aさん:赤字で「プラットフォーム」と書いてある部分が「ラベル」なんですね
開米 :そうです。「ラベル」はこの場合、「話題」を示します。「今からプラットフォームについて書きますよ」という話題を明示した上で、具体的な中身を書く方法です
Aさん:でも・・・・「プラットフォーム」はPythonですけど、「GUIアプリケーションのテスト自動化ツール」というのはプラットフォームの話じゃないですよ?
開米 :そこが大事なところです! それはつまり、この1箇条は本当は2箇条に分けるべきだった、ということなんですよ

Dogtail-5.jpg


Aさん:「○○○○」のところに、別なラベルをつけるんですね
開米 :その方がいいと思います。考えてみてください

こんなふうに、ラベルをつけようとすると「一文で書いていたけれど、実は2つに分けるべきだった」と気がつくことは少なくありません。「一度に1つのことしか言わない」というのは、わかりやすく説明するための鉄則なので、これに気がつきやすくなるだけでも「ラベル付き箇条書き」を普段から心がける価値があります。

なお、その後Aさんと開米で5分ぐらい考えて整理すると、こんなふうになりました。(文章で書くのをやめて、表形式にしました)

Dogtail-7.jpg

↑実はこの結果は5分でサクッと作ったものだけに、イマイチ違和感を感じる部分があります。たとえば「用途」と「自動化方針」の2つの項目などはもっとうまい分け方とラベリングがあるんじゃないか、という気がします。

ですが、このまま載せておくことにしました。完璧な例ではありませんが、逆にそのほうが「考えてみる」題材としては役に立つでしょう。「ここがダメ、こうしたほうがいい」とツッコミを入れてみてください。それが「わかりやすく書く」腕をあげるための経験値になりますので。


質問、ご意見等はtwitter, facebook, メール等で私宛にお尋ねください。
→ 開米へのお問い合わせ先
http://ideacraft.jp/cms/main-contact.html