トピックス

2019年6月28日に、令和初の2019年度総会・第21回研究会を大崎ウエストギャラリー（東京都品川区）にて開催しました。

 

はじめに、2019年度定期総会を開催しました。出席者が27名で委任状が53個提出されており総会の成立条件（会員数の1/2）を満たしていることを確認しました。そして、2018年度の事業報告と決算報告、2019年度の事業計画と収支計画と役員改選について事務局から説明しました。皆さんの承認をいただき、無事に総会を終了しました。

総会では、文書品質モデルの普及や実用化に向けて、活動を活性化すべきとの意見を頂戴しました。この研究会は、皆さんとご一緒に進めています。今年度も、ワークショップや大会などへのご参加を含めて、ご協力くださいますようお願いします。

 

次に、第21回研究会では、新森昭宏さん（インテック）からご講演「自然言語処理技術の最近の発展と日本語文チェックへの適用について」と、ASDoQからシステム文書品質モデルに関するワークショップを行いました。

新森さんのご講演では、ご自身が開発され、社内で文書改善のために取り組まれている日本語文チェックツールについてお話しいただきました。

日本語文チェックツールはインテック社内の議事録・設計書・報告書等のチェックに使われています。ツールのポイントは下記です。

• オープンソースソフトウェアツール（redpen他）を最大限に活用した
• 特にExcelファイルからのテキスト抽出を工夫した

しかし、ルールベースのため指摘の質に改善の余地があるそうです。具体的には下記です。

• 文脈を把握した上での指摘
• 指摘するだけでなく、OK例の提案

新森さんは現在、自然言語処理のための最先端言語モデルである「BERT」の成果を日本語文チェックツールに応用する研究をされており、その研究内容や今後の可能性もご紹介くださいました。BERTに関して、ご自身でプログラミングしたりCourseraのeLearningで学ばれたご経験を踏まえて、分かりやすく解説していただきました。フロアからは質問が飛び技術的な議論が交わされ、充実した時間でした。

BERTは、例えば、学習していないシステムにとって新しい文を与えたときに、それが曖昧であるか否かを識別できる能力を持ち得ます。この技術を発展させることで、ASDoQで関心を持つ文書品質のいくつかの指標を、自動的に測定できる可能性がありそうです。

講演の後には、文書品質モデルの普及と実用化への取り組みとして、測定項目をより使いやすくするためのワークショップを、以下のステップにて行いました。

1. 個人ワークにて文書品質モデル内の測定項目に関して、次の点を考察
   • 説明文（意味の確認）
   • NG例
   • 他の品質特性との関係
2. グループワークにて、それぞれの理解や考察を共有
3. グループ毎に発表し、議論

今回は6グループに分かれて作業をしました。

1班：読み手と書き手の知識量に乖離があるという事実に着目し、用語定義の必要性を提案くださいました。

2班：例文を作成し、どの測定項目に違反しているか整理していく中で、測定項目に一意性が無いことを発見しました。

3班：測定項目の説明として「NG例」「NG理由」「NGの影響」「OK例」を提案くださいました。

4班：完全性の正確性（記述内容が検証可能である）に着目し、非曖昧性や合目的性との繋がりを発見しました。

5班：上流（書き手）と下流（読み手）の暗黙値について着目し、闇雲に指摘検証するのも考えものという新しい発想を得ました。

6班：NGの具体例は必須と提案くださり、さらに測定項目は実は最小粒度ではないというアプローチをしてくださいました。

発表いただいた内容を後日に事務局でまとめ、サマーワークショップ(*)のインプットにします。

(*)サマーワークショップ

毎年ASDoQでは、夏の京都@鴨川で合宿形式のワークショップを開催しています。鴨川のせせらぎに涼しさを感じつつ、開発文書について熱い議論を交わします。

今年は8月23日（金）-24日（土）を予定しています。会員の皆様には，MLでご案内しました．申込みURLを以下に示します．

https://asdoq.jp/eguide/event.php?eid=37

皆さんのご参加お待ちしております。

今年度も研究会、ワークショップ、ASDoQ大会を計画しています。皆さんからのご意見やご要望を取り入れながら進めていきたいを思いますので、どうぞよろしくお願いします。

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は、講演で得られた知見や、ポスター発表で紹介された取り組み、また参加者の方々との有意義な議論などの本大会の結果を、今後の研究会活動に活かしていきます。