IT技術者が説明上手になるための七つの法則

IT技術者が説明上手になるための七つの法則

1. 1. IT技術者が説明上手になるために 知っておくべき七つの法則 ～GPS & ラベリング～ アイデアクラフト 開米瑞浩 http://ideacraft.jp Android Bazaar & Conference 2018 Spring
2. 2. Copyright アイデアクラフト 2018 開米瑞浩：自己紹介  1967年生まれの元組み込みプログラマー  Windows2.0のアプリ開発経験あり  2003年頃から「説明する技術」の教育・執筆等  難解な技術情報やビジネススキームの図解が得意 ➢ （インフォグラフィックではなくロジック図解）  Software Design誌の連載「RDB性能トラブルバスターズ奮闘 記」の執筆を担当  IT研修のトレノケート社に「言いたいことをサクッと図で表す 技術」講座を提供  SEプラスのSEカレッジで「エンジニアを説明上手にする図解術 」を担当  最近はテック企業の広報文書の執筆も ➢ ホワイトペーパー、メルマガ、Web記事などの執筆にお悩み の会社の方はご相談ください 1
3. 3. Copyright アイデアクラフト 2018 著書 複雑な情報をわかりやすく表現する技術を磨きたいとき はご一読ください エンジニアを説明上手にする本 （翔泳社） 2
4. 4. Copyright アイデアクラフト 2018 広報文書ライティング 地理情報マーケティングシステム APIマネジメントシステム ネットワーク最適化サービス ホワイトペーパー CDNサービス 組み込みシステム高速化ツール IT資産管理システム 経費管理クラウド AIによる医療革新の展望 メルマガやWeb原稿 Gitトレーニング講座 VPN、UTM、IoT、 BIM/CIM、 VR/AR、 特権ID管理システム ・・・などなど 3
5. 5. Copyright アイデアクラフト 2018 ギャップを埋めるために必要なものは？ Tech カンパニー 一般事業 会社 大きなギャップ …… 通訳が必要 4
6. 6. Copyright アイデアクラフト 2018 「説明」の必要性と難易度は高まる一方 良好なコミュニケーションが不可欠 空気を読む力 にこやかに応対する力 ではない！！ 5
7. 7. Copyright アイデアクラフト 2018 広報文書ライティングの実例  クリエーションライン社のGitトレーニング講座プレスリリース （開米が制作に協力しました） https://www.creationline.com/lab/gitlab/21110 6
8. 8. Copyright アイデアクラフト 2018 初めに全体の構成を設計する 7
9. 9. Copyright アイデアクラフト 2018 図版を制作 8
10. 10. Copyright アイデアクラフト 2018 図版を制作 9
11. 11. Copyright アイデアクラフト 2018 図解のススメ 文章だけでは通じない。図解しましょう。 10
12. 12. Copyright アイデアクラフト 2018 図解するとイメージが伝わる SQLのSELECT文動作イメージ図解 11
13. 13. Copyright アイデアクラフト 2018 図解を考えるためのGPS Ｇ グループ構造 Ｐ パラレル構造 Ｓ シリーズ構造 12
14. 14. Copyright アイデアクラフト 2018 Ｇ：グループ構造 例文1：勝利を得るためには心技体の充実が必要です。 勝利 心 技 体 勝利 心 技 体 体 技 心 勝利 枝分かれ型 ピラー型 中心型 13
15. 15. Copyright アイデアクラフト 2018 Ｓ：シリーズ構造 例文３：花粉症の初期症状は、くしゃみ・鼻水・鼻 づまり・目のかゆみ・微熱などで、風邪に似ている ため花粉症と気づかず放置されている場合がありま す 花粉症の初期症状 くしゃみ 鼻水 鼻づまり 目のかゆみ 風邪に似ている 花粉症と 気づかず放置 14
16. 16. Copyright アイデアクラフト 2018 Ｐ：パラレル構造 例文６：自動運転の技術が進めば、一般のドライバ ーにとって運転の負担が減るだけでなく、体の不自 由な人も自家用車で移動できるようになったり、無 人タクシーなどの新しい業態が生まれたりすること も期待出来ます。 一般のドライバー 運転の負担が減る 体の不自由な人 自家用車で移動 できるようになる自動運転技術 の発達 輸送業界 新しい業態が 生まれる (無人タクシー) 領域 変化 15
17. 17. Copyright アイデアクラフト 2018 G/P/Sの構造に注目しよう Ｇ型構造 （グループ、同種/同格のものの集合） 16
18. 18. Copyright アイデアクラフト 2018 G/P/Sの構造に注目しよう Ｐ型構造 （パラレル、並列的な関係） 17
19. 19. Copyright アイデアクラフト 2018 G/P/Sの構造に注目しよう Ｓ型構造 （シリーズ、因果関係/位置関係/時系列など） 18
20. 20. Copyright アイデアクラフト 2018 大量の情報は分解してラベルをつけよう 語学 会計 IT 大量の情報 ラベル 分解 19
21. 21. Copyright アイデアクラフト 2018 ラベリング前の原文 【Sプロジェクト業務検証報告】（原文） Sプロジェクトで採用を予定している新しい業務フローにつき、手順 書に基づいてデータの入力・修正作業を行いました。当初は手順書に 不明瞭な部分が多く、手順書通りに作業をしても最終チェックでエ ラーになるケースが多発しました。このままでは入力作業工数が想定 の50%増程度になると考えられます。詳しく調べてみると、作業途中 で些細な入力ミスが多く発生していることがわかりました。これらの エラー検出や自動補正機能を持たせることで、省力化が可能になると 思われます。また、手順書も品質向上が必要と判断しました。 このままでは読みづらい・・・・ 20
22. 22. Copyright アイデアクラフト 2018 分解してラベリングすると・・・ 【 Sプロジェクト業務検証報告】（改善例） ■タスク概要 ➢ Sプロジェクトで採用予定の新業務フローが効率良く実施できるか検証する ➢ 手順書に基づいて実際にデータの入力・修正作業を行う ■問題点 ➢ 手順書に不明瞭な部分が多かった ➢ 手順書通りに作業をしても最終チェックでエラーになるケースが多発した ➢ 作業途中で些細な入力ミスが多く発生していた ■予想される悪影響 ➢ 入力作業工数が想定の50%増程度になると考えられる ■考えられる対応策 ➢ 手順書の品質を向上させる ➢ 入力エラーの検出機能を組み込む ➢ 入力エラーの自動補正機能を組み込む 21
23. 23. Copyright アイデアクラフト 2018 ラベルありのほうが読みやすい 悪影響 概要 Sプロジェクトで採用予定の業務フローを… 手順書に不明瞭な部分が多かった・・・ 入力作業工数が想定の50%増程度に・・・ 問題点 対応策 手順書の品質を向上させる・・・ ラベル 本文 ただし、この種のラベルだけだと結局本文も読む必要あり 22
24. 24. Copyright アイデアクラフト 2018 カテゴリーとサマリーでラベリング 悪影響 サマリーカテゴリー 本文 手順書不明瞭 エラー多発 入力ミス多発 問題点 手順書に不明瞭な部分が多かった 手順書通りに作業をしても最終チェッ クでエラーになるケースが多発した 作業途中で些細な入力ミスが多く発生 していた 対応策 サマリーがあると本文を読まなくてもよい 23
25. 25. Copyright アイデアクラフト 2018 その他ちょっとしたノウハウ  ラベル入れ替え禁止  静的構造を探せ  フロー＆コメントを作れ  5箇条以上ならグループ化せよ  コピペ乱用禁止、差異表示に注意  定型パターンを発見せよ  スペースには意味がある 今日は省略 24
26. 26. Copyright アイデアクラフト 2018 定型パターン：事故の6項目マトリックス 原因 事故 損害 対策 対処 回復 それが事故（障害） を引き起こす 事故によって 損害が発生する 何らかの原因が 存在する 対処は拡大防止や 応急処置のこと 損害は回復/復旧 させる必要がある 原因には 対策が必要 25
27. 27. Copyright アイデアクラフト 2018 事故の6項目マトリックスのイメージ 原因 事故 損害 対策 対処 回復 26
28. 28. Copyright アイデアクラフト 2018 事故の6項目で整理：ある交通事故の発生 超過勤務が続いて疲れが溜まっていたＫさんは、居眠り運転をし て、ある道路で電柱に接触する事故を起こした。車は大破して１車 線を塞いで止まってしまい、走行不能となって１時間後に撤去。幸 い他の被害はなく、自分自身もほとんど怪我はなかったが、車は買 い換えが必要そうだ。 27
29. 29. Copyright アイデアクラフト 2018 事故の6項目：ある交通事故の発生 超過勤務の 疲れ 居眠り 運転 電柱に接触 １車線塞ぐ 車は大破 １車線 通行止め （なし） １時間後 に撤去 買い換え 必要 なし （なし） 原因 事故 損害 28
30. 30. Copyright アイデアクラフト 2018 ビジネス実務者がすべき仕事とは？ 制作物（文書） 材料出し 設計 仕上げ 文章 スライド 目的 情報の設計図 （図解） • 走り書きの文章 • 箇条書き • キーワードの羅列 対象分野の知識 コーヒー豆の原種にはアラビカ 種、ロブスタ種、リベリカ種の ３種類があります コーヒー豆の原種 アラビカ ロブスタ リベリカ コーヒー業界 コーヒー豆の原種 アラビカ ロブスタ リベリカ • 内部ミーティング用資料 • 会社案内掲載用図版 (不要な場合も多い) 29
31. 31. Copyright アイデアクラフト 2018 ロジック図解とイメージビジュアルの違い 当社は体と心の両面からお客さまの健康をサ ポートし、幸せな生活に貢献することで笑顔 あふれる元気な社会をつくります ロジック図解化 心 体 健康 幸せな 生活 笑顔 元気な 社会 サポート イメージビジュアル化 30
32. 32. Copyright アイデアクラフト 2018 A beautiful night in Yokohama... 31
33. 33. Copyright アイデアクラフト 2018 ロジカル・コミュニケーションが求められる場面 状況把握 詳細計画 実行 現実世界 知識 意思 決定者 現場担当者 方針立案 ティーチング ヒアリング、 レポーティング インストラクション プレゼン テーション ディレクション 概要だけでいい 詳細が必要 32
34. 34. Copyright アイデアクラフト 2018 知識・実践・修正、足りていますか？ 上達するためにはどんな仕事でも知識・実践・修正が必要 知識 実践 修正 １日５分～１０分でも、意識的に行う 他の人からのフィードバックをもらう 知っておくと役に立つ知識を得る 33
35. 35. Copyright アイデアクラフト 2018 まとめ ＧＰＳとラベルを考えて図解しよう！！ 技術文書（広報用含む）の執筆・図解にお困りの方は ご相談ください 34