トピックス

2019年2月20日　名古屋ウインクあいちにて、第20回研究会を開催しました。

今回の研究会では、ASDoQ大会2018で審査員特別賞を受賞された発表チームのお一人であるデンソークリエイトの山路厚さんに、より詳しく話して頂きました。「開発文書の品質の可視化」と題して、原理的思考に基づいた正しく伝わるレビューの記録方法の講演とワークをして頂きました。

ワークでは実際に文書のレビューを行いました。 相手に正しく伝わる指摘を作成する難しさを改めて体感できました。

現場のレビュー指摘内容は間接情報が多く、指摘内容を理解するのにかなりの労力を使っています。 デンソークリエイトでは、指摘内容を直接情報で理解できる仕組み（Lightning Review）を導入しているそうです。それにより以下のような効果が出ているそうです。

・差し戻し件数が1/8に減少した
・軽微な指摘も全て記録になった
・カイゼンのための材料（記録）を蓄積できるようになった

そして、レビュー指摘の記録がどのように文書品質に役立つかを皆で議論しました。

次に、ASDoQ運営委員の山崎伸洋さんの司会で、システム開発文書品質モデル（ASDoQ発行）の継続的な改訂のために改善点の討議を行いました。主に以下のようなトピックで議論をしました。

・文書品質モデルがなぜ必要か
・使いにくい、わかりにくい点はないか
・どのように使えるのか

個人ワークの後はグループで討議しました。

発表の様子（グループ1）
・文書として体を成すという視点で文書品質を定義しているのは有意義
・分類が難しいため、ツールで分類を自動化できないか
・人のスキルに依存する


発表の様子（グループ2）
・レビュー時に有効（指摘傾向の分析）
・分類に時間がかかるのがネック
・完全性、規範適合性がイメージしにくい


発表の様子（グループ3）
・教育に活用したい
・使う人に応じた使い方ガイドラインが必要（初級編、中級編等）


発表の様子（グループ4）
・具体的にカウントできるものを持ってくると、基準がわかりやすく測定しやすくなるのでは（SQuaREが適していそう）
・完全性という項目のネーミングを見直してみてはどうか
・フローチャート等で分類ガイドを作る


発表の様子（グループ5）
・使い方ガイドが必要
・項目が多く分類を難しくしているため、項目を減らす
・項目は技術/テクニカルライティングの2つに分ける

まとめますと、以下の必要性が分かってきました。

・各品質特性の更なる明確化
定義と範囲の更なる明確化、及び、特性の分類を可能にする具体例
・使い方のガイドライン
使う場面にあわせて、文書品質モデルの有効性と使い方を示すもの

引き続き、システム開発文書品質モデルの有効な活用のための改善を進めていく予定です。

2018年11月2日に、名古屋大学にてASDoQ大会2018を開催しました。
今年は、野依良治教授のノーベル化学賞受賞を記念して建てられた野依記念学術交流館にて、大きな窓からは緑をふんだんに感じることができる会場での開催となりました。

（名古屋大学　野依記念学術交流館）

今回の大会は「文書技術の展開～記述と思考の技術と品質を考える～ 」をテーマに、記述と思考技術の視点から、開発文書の品質を高めるヒントを探りました。

第1部のチュートリアル1では、 伊藤 洋子 氏が「ソフトウェアの利用品質を変えるUXライティング」のタイトルでご講義くださいました。システム利用のユーザ体験を向上させるUXライティングが登場した背景、その必要性および重要性について例題を交えてわかりやすくご説明いただきました。

（チュートリアル1：伊藤洋子氏）

並行して開催したチュートリアル2では、玉城 理恵子 氏が「言葉＋αの効果を持つグラフィックレコーディングを試してみよう」のタイトルでご講義くださいました。話の内容をリアルタイムに図に落とし可視化、共有する手法であるグラフィックレコーディングを、グループワークを通して体験できました。

（チュートリアル2：玉城理恵子氏）

第2部の招待講演1では、髙橋 尚子 氏が「『情報』で変わる文書のかたち－これからの文書をつくる技術と教育－」のテーマでお話しくださいました。女性SE一期生としてご活躍なされた当時の開発現場の貴重な体験談を交えつつ、高校・大学における情報教育のこれからの動向や、情報教育や情報そのものがもたらす、文書をはじめとする表現の変化など、幅広い視点で「情報」についてお話いただきました。

（招待講演1：高橋尚子氏）

招待講演2では、皆川 誠 氏が「モデルとドキュメントの親密な関係 - モデルを活用してソフトウェアの設計品質を上げる -」のテーマでお話しくださいました。車載ソフトウェア向け標準プラットフォーム仕様であるAUTOSARを例にして、モデルとドキュメント(仕様書)との関係についてお話いただきました。また、簡単なゲームを題材としてドメイン・フレームワークの考え方を示し、モデル上での推敲による品質向上の一例を示していただきました。

（招待講演2：皆川誠氏）

第2部の講演会の後半は、ご講演者4名に山本 修一郎 氏を交え、パネルディスカッションを行いました。参加者からの疑問にそれぞれの立場や経験からお答えいただきました。

（左から パネリスト：高橋氏、皆川氏、伊藤氏、玉城氏、山本氏、モデレータ：栗田氏）

引き続いて行ったポスター発表では、9件の文書品質に関わる取り組みの発表がありました。レビュー、教育、マネージメントなど様々な切り口から開発文書の品質向上に取り組む事例が紹介され、参加者共に議論しました。
また、今年の会場には、講演者・チュートリアル講師と個別で懇談できるような場も用意しました。

ポスター発表では参加者の投票による最優秀賞と、審査員の投票による審査員特別賞、審査員個人賞を表彰しました。町田 欣史 氏が最優秀賞と審査員特別賞を受賞されました。審査員は、パネルディスカッションのパネリストの方々にお願いしました。

●最優秀賞、審査員特別賞：『「伝わる技術文書の書き方」の教育事例とその結果』
●●町田 欣史 氏（株式会社NTTデータ）

（最優秀賞：町田欣史 氏）

町田 欣史 氏には副賞として、文書品質に関連する以下の3冊が贈られました。
・TC協会（著）「日本語スタイルガイド (第3版）」
・石黒 圭（著）「よくわかる文章表現の技術〈1〉表現・表記編 (新版) 」
・三浦 順治（著）「英語流の説得力をもつ日本語文章の書き方」

さらに、審査員特別賞には、投票数が同数の山路 厚 氏、竹下 千晶 氏、田口 知明 氏のチームも受賞されました。

●審査員特別賞：『レビュー指摘記録の改善による開発文書の品質向上の取り組み』
●●山路 厚 氏，竹下 千晶 氏，田口 知明 氏（株式会社デンソークリエイト）

（審査員特別賞：山路 厚 氏、田口 知明 氏）

さらに、審査員個人賞の発表もあり、以下の方々に、それぞれ個人賞が贈られました。
個人賞には、審査員が選んだ書籍が副賞として贈られました。

●伊藤賞：『レビュー指摘記録の改善による開発文書の品質向上の取り組み』
●●山路 厚 氏，竹下 千晶 氏，田口 知明 氏（株式会社デンソークリエイト）
●●[副賞] 鈴木孝夫（著）「ことばと文化」

●玉城賞：『「伝わる技術文書の書き方」の教育事例とその結果』
●●町田 欣史 氏（株式会社NTTデータ）
●●[副賞] 清水　淳子（著）「Graphic Recorder ―議論を可視化するグラフィックレコーディングの教科書」

●高橋賞：『事例報告：開発文書ライティング教育への取り組み』
●●山本 雅基 氏（名古屋大学情報学研究科）                
●●[副賞] 高橋尚子（著）「ゼロからはじめる　情報リテラシー（電子メールからグループウェアまで）」 

●皆川賞：『レビュー指摘記録の改善による開発文書の品質向上の取り組み』
●●山路 厚 氏，竹下 千晶 氏，田口 知明 氏（株式会社デンソークリエイト）
●●[副賞] 木下 是雄（著）「理科系の作文技術」

●山本修一郎賞：『「伝わる技術文書の書き方」の教育事例とその結果』
●●町田 欣史 氏（株式会社NTTデータ）
●●[副賞] 吉田 裕子（著）「人一倍時間がかかる人のための すぐ書ける文章術 ムダのない大人の文章が書ける」
 

最後に、参加者の方にいただいたアンケート結果を示します。

今回のASDoQ大会にご参加くださった皆さん、ご講演者の方々、またASDoQ大会開催に内外からご協力、ご支援、ご後援くださった方々に感謝いたします。ASDoQは、講演で得られた知見や、ポスター発表で紹介された取り組み、また参加者の方々との有意義な議論などの本大会の結果を、今後の研究会活動に活かしていきます。

今回の研究会では、システム開発文書品質の「完全性」を満たす方法を、次の流れで討議しました。

1. サマーワークショップの報告と意見交換
2. システム開発文書の品質特性「完全性」を満たす文書化技術の列挙
3. 文書化技術を使う具体的な方法の検討
4. グループ討議の結果の共有と意見交換