NCES Education Program

ドキュメントレビュー（1回目）

お申込みは↓のボタンから

募集は締め切りました

科目名 ドキュメントレビュー（1回目）
開講日 ［Zoom講義］　2024年8月2日（金曜日）
開講時間 ［Zoom講義］　9時30分から17時00分　（9時00分開場，集合時刻9時15分）
受講申込期間 2024年6月1日（土曜日）～2024年7月18日（木曜日）
受講料 25,000円（税込）
enPiT-Pro Embの「名古屋大学車載組込みシステムコース」のコース受講料に含まれますので，同コースの履修者には請求しません．
定員（先着順） 40名
会場・留意事項 ・テキストは，受講者に事前に送付します．
・勤務先や自宅などから，Webで受講してください．
・Webでの講義配信に，Zoomを使用します．
・必要な機材は，PC，ヘッドセット，通信環境です．カメラは任意です．
詳しくは，こちらでご確認ください．
・https://zoom.us/test　でZoomの基本動作を確認できます．
・質疑応答やグループワーク（発表含め）等は，Zoomで実施します．
・修了テストは，Webテストや，問題のWeb配信とE-mailでの提出などを検討中です．
・ネットワークトラブルにより受講ができなかった受講者には，後日に録画データを配信します．
・インターネット回線（モバイルルーター含む）は，通信容量制限や速度制限のない契約プランでご使用ください．制限を超えると画像が映らない，音声が途切れる等のトラブル発生の可能性があります．
講師 塩谷敦子（イオタクラフト）
講師は都合により変更する場合があります
講座概要 ソフトウェア開発では，要求仕様書やアーキテクチャ設計書など複数種類の開発ドキュメントが作成されます．本講座では，それらの開発ドキュメントに対するレビュー技術を学びます．

本講座で学ぶ開発ドキュメントのレビュー技術は，単に文書を校正するだけではなく，技術者の育成までを視野におきます．我々は，このドキュメントレビューを，文書診断と名づけます．

文書診断では，主に次の5点に注目します．
・表記，表現が適切か
・読みやすいか
・理解しやすいか
・論理的に記述しているか
・開発に必要十分な情報（合目的，正確，妥当）が記載されているか
そして，この5点の診断視点を例として，自らの診断視点を検討します．これは，開発文書のあるべき姿のとらえ方，そのための表現のしかたを見直すことに繋がります．
(※)5点の診断視点は，システム開発文書品質研究会(ASDoQ)発行「システム開発文書品質モデルVer.1.0」を参考にしたものです．

そして，文書診断により，文書の品質が向上すると共に，診断を受けた文書を作成した技術者に不足する文書力の領域が明らかになります．このため、それぞれの技術者に適した効果的な育成が可能となります．さらに，文書診断を行う技術者自身も，客観的にドキュメントを読み改善するコツを得ることで，自らの文書力を向上させます．

本講座は，全てのソフトウェア開発者に有効です．
(補足）本講座は，H22年度～H26年度に実施した「ドキュメントレビュー」を改訂した内容です．
実習機材 特になし
到達目標 ドキュメントレビューに関して理解を深め，開発現場において実践できるようになる
対象者 ソフトウェア開発業務に従事されている方
H21年度に「レビュー工程を成功させる指導技術」講座を受講された方は，講義の一部が同じ内容となります．ご了承ください．
前提条件 特になし
講義計画 1. レビュー総論
・レビューの位置づけと種類
・レビューの有効性

2. ドキュメントレビュー要説
・ソフトウェア開発とドキュメンテーション
・ドキュメントレビューとは
・ソフトウェア文書診断
・診断視点の検討
・文書診断によるドキュメントレビュー

3. 文書診断の実践
・診断項目の確認
・指摘事例
・診断演習
・ドキュメントレビュー実習

4. 図表のドキュメントレビュー
・図，表，文章
・図表のレビュー
・表の例
・図の例：UMLダイアグラム
・図表が表現できること・できないこと
評価方法 enPiT-Pro Embの「名古屋大学車載組込みシステムコース」履修者がこの科目を受講した場合の修了認定基準は，次のとおりです．
・理解度テスト60点以上
・全時間数を出席していること
これまでに受講された方々の声 レビューを実施するタイミング・各工程での成果物の取り決めなどのソフトウェア開発プロセスの表面的な内容が整ってきた企業が，手順や成果物の中身を成熟させるためのステップに上がるのによいセミナーだと感じました． セミナーの講師の方々も企業での研究開発経験者であり，企業内における改善の進め方を熟知されているようで，信頼できると思います．
本講座を受けたことにより，ドキュメントレビューの重要性とドキュメントレビューのポインタが理解できました．開発現場でも実践していきたいと思います．
品質良いドキュメントかどうかを判断するために，単純にドキュメントレビューでの指摘数やレビューア評価で決めるのではなく，ドキュメント品質を評価する基準がかなり重要であることが分かりました．

＊enPiT-Pro Embの講義について語っていただいた，受講者の声（インタビュー形式）はこちらから．
備考 複数回開講する科目の場合，改良を目的として教材をマイナ改訂する場合があるので，完全に同一の内容とならない可能性もございます．しかし，到達目標や扱う内容に変わりはありません．
お申込みや開講に関わる諸条件は，公開講座開講規約のページをご覧ください．
enPiT-Pro Emb向けの文部科学省BP要件該当授業時間数（実務家教員）情報：この科目は6時間です．