１．ソフトウェア開発におけるドキュメント（要件定義書・設計書）の役割

　　（１）．文書化の不備によるトラブルと品質問題の発生

　　　　ａ．開発プロセスにおける不具合の実態と原因

　　　　ｂ．なぜ要件定義書・設計書の記述不備が品質問題を引き起こすのか

　　　　ｃ．不明確な記述が原因となるトラブル、手戻り、品質低下

　　　　【演習】自身の経験から文書不備による問題事例を共有

　　（２）．開発プロセスにおける文書の重要性と品質への影響

　　　　ａ．ソフトウェア開発プロセスにおける成果物としての文書の意義

　　　　ｂ．プロセス品質とソフトウェア品質の関係

　　（３）．開発プロセスにおける文書の6つの役割

　　　　ａ．工程間インタフェースの明確化：前工程からの引継ぎ、次工程への伝達

　　　　ｂ．工程作業の管理：何をどこまで完了したかの可視化

　　　　ｃ．品質の作り込みと検証：レビューによる品質確保

　　　　ｄ．品質保証：成果物として品質を証明する

　　　　ｅ．開発プロセスの定義：文書体系がプロセスを定義する

　　　　ｆ．ナレッジの蓄積：保守・改修時の情報源

２．ドキュメンテーションに基づく開発プロセスの進め方

　　（１）．ソフトウェア開発におけるドキュメンテーションの位置付け

　　　　ａ．「書くこと」が「考えること」－文書化は思考の整理

　　　　ｂ．「書けない」ことは「決まっていない」証拠

　　　　ｃ．文書で考え、文書で進める開発プロセス

　　（２）．開発プロセスの工程と文書体系の関係

　　　　ａ．要件定義、基本設計、詳細設計の文書構成と記載内容

　　　　ｂ．文書構成（目次）が作業の項目と内容を決める

　　　　【演習】開発プロセスの各段階で決めるべきことを整理する

　　（３）．ソフトウェア品質向上のための文書化のポイント

　　　　ａ．要件定義書・設計書作成の心得：書く前に考える、構造化してから書く

　　　　ｂ．図表記載の心がけ：図で全体像、表で詳細、文章で補足

　　　　ｃ．読み手を意識した文書の構成と内容：知りたいことは何か

　　　　【演習】読み手を意識して書くべき内容を決める

　　（４）．開発文書作成における生成AIの活用と影響

　　　　ａ．文書作成における生成AIの活用可能性と限界

　　　　ｂ．AIが作成した文書と人間が行うべき「決定」の本質

３．テクニカルライティングの基礎：論理的に説明し、わかりやすく書く技術

　　（１）．文書のわかりやすさと論理展開

　　　　ａ．主張や説明の根拠を明確にする

　　　　ｂ．技術的判断のプロセスを可視化する

　　　　【演習】理由を明示して結論を述べる

　　（２）．文書に書く内容を整理する

　　　　ａ．MECEで情報を「漏れなく、ダブりなく」整理する

　　　　ｂ．So What?（だから何？）/ Why So?（なぜ？）で論理を組み立てる

　　　　ｃ．メッセージ → 理由 → 根拠の階層構造

　　　　【演習】システム構成要素をMECEで整理する

　　（３）．構造化した情報を文書構成に変換する

　　　　ａ．頭括型構成：結論を先に示して説得力を高める

　　　　ｂ． 1段落=1トピックの原則で読みやすさを実現する

　　　　【演習】技術説明を頭括構成で書いてみる

　　（４）． テクニカルライティングに必要な3つの原則

　　　　ａ．明確性（Clarity）：曖昧さを排除し、誰が読んでも同じ理解

　　　　ｂ．簡潔性（Conciseness）：冗長表現を避け、必要十分な記述

　　　　ｃ．一貫性（Consistency）：用語・形式・粒度の統一

　　（５）．曖昧表現を排除し、正確に書く技術

　　　　ａ．主語を明示する：「処理を行う」→「サーバーが処理を実行する」

　　　　ｂ．能動態と受動態の使い分け：動作主体を明確にする

　　　　ｃ．一文を短くシンプルに：目安は60文字以内、一文一義

　　　　【演習】読みにくい文を簡潔で明瞭な記述に改善する

　　（６）．技術文書特有の技法

　　　　ａ．図表を効果的に使い、文章と連携させる

　　　　ｂ．階層的番号付け（1.2.3方式）で情報の位置を明確化

　　　　ｃ．箇条書きの効果的な活用：並列関係と階層関係の表現

　　　　ｄ．相互参照の技術：「詳細は○○を参照」の適切な使い

４．実務で活用できる文書作成の要点

　　（１）．ソフトウェア開発文書の種別ごとの実践的な作成方法

　　　　ａ．前提条件とスコープの明示：何を書き、何を書かないか

　　　　ｂ．ソフトウェア要件定義書の構成と記載内容

　　　　ｃ． 基本設計書の構成と記載内容：目次例と記述例

　　　　ｄ．詳細設計書・インタフェース仕様書の作成ポイント

　　（２）．文書品質向上のために：セルフチェックとレビューへの応用

　　　　ａ．システム開発文書に求める品質特性

　　　　ｂ．レビュー観点と効果的なレビューの進め方

　　　　ｃ．レビュー結果のフィードバックと改善サイクル

　　　　ｄ．変更管理の手順と方法のポイント

５．ドキュメンテーション実践演習：問題のある設計書の改善

　　（１）．設計書サンプルの分析（グループワーク）

　　　　ａ．どこが問題か？なぜ読みにくいのか？を議論する

　　　　ｂ．構成、論理、表現の観点で問題点を洗い出す

　　（２）．文書の改善実践：「文書のリファクタリング」

　　　　ａ．章立てを見直し、適切な構成に組み直す

　　　　ｂ．曖昧な表現を具体化し、箇条書きや図表を活用する

　　（３）．成果発表と全体共有、フィードバック

　　　　ａ．各グループから改善後の文書を発表、全体で共有

　　　　ｂ．他のグループからの質問、フィードバック

　　　　ｃ．講師からの講評と解答例の紹介

６．まとめと振り返り・講師からの全体フィードバック

　　（１）．重要ポイントの総復習：文書化を定着させて品質向上するために

　　（２）．講座の振り返り：学びと気づきの確認

　　（３）．質疑応答