開発ドキュメントと開発手法 (1/3)

【楽々デブドックを書こう!】手法別開発ドキュメントの書き方

【楽々デブドックを書こう!】手法別開発ドキュメントの書き方

第1回:開発ドキュメントと開発手法

著者:シンクイット編集部

公開日:2008/02/07(木)

ウォーターフォールモデルとアジャイルモデルを取り上げる

2008年2月の特集「開発ドキュメント」の木曜日は、実際の現場で使われている開発ドキュメントについて紹介する。本連載では「開発手法」という切り口で開発ドキュメントについて解説していく。取り上げる開発手法は、ウォーターフォールモデルとアジャイルモデルだ。第1回では開発ドキュメントについて再考し、それぞれの開発手法について、簡単に説明していく。

ソフトウェア開発において、開発ドキュメントはなくてはならないものであるともいえわれているが、なぜ必要なのだろうか。つまり、開発ドキュメントとは何であろうかという疑問がある。

  • 開発ドキュメントはコミュニケーションツールだ
  • 必要な情報を伝えることが重要だ

表1:開発ドキュメントとは

開発ドキュメントはコミュニケーションツール

機能の不備や仕様変更などが行われると手戻りが発生し、スケジュールが厳しいものへと変化していく。もともとスケジュールはある程度の余裕をもって決められているはずなのだが、それでも手戻りが発生することで、うまくいかないこともある。また、最終的な成果物ができたとしても、ユーザが納得するものではなかったりするケースもあるだろう。

機能の不備や仕様変更などが行われると手戻りが発生し、スケジュールが厳しいものへと変化していく。そのためにスケジュールにはある程度の余裕があるはずなのだが、それでもやはりうまくいかないこともある。また、最終的な成果物ができたとしても、ユーザが納得するものではなかったりすることもある。

このようなことがなぜ起きるのか。すべてはドキュメントにポイントがあるといえる。開発ドキュメントはただ書けばよいというものではない。その本質は「必要な情報が伝わること」である。つまり、伝わらなければ意味がないともいえる。これはまさにコミュニケーションだ。人間同士のコミュニケーションでも、必要な情報が伝わらなければ、ちぐはぐな会話になってしまう。だが、その必要な情報をドキュメントで伝えることが難しいのもまた事実である。 次のページ



INDEX
開発ドキュメントと開発手法
ウォーターフォールモデルとアジャイルモデルを取り上げる
 さまざなま開発手法「ウォーターフォールモデル」
 それぞれの得意分野
【楽々デブドックを書こう!】手法別開発ドキュメントの書き方
第1回:開発ドキュメントと開発手法
第2回:開発に共通するドキュメント
第3回:ウォーターフォールにおけるドキュメント作成ポイント
第4回:アジャイルにおけるドキュメント作成ポイント

人気記事トップ10

人気記事ランキングをもっと見る

企画広告も役立つ情報バッチリ! Sponsored

ClickHouse Cloudが実現した広告運用SaaS「ATOM」のデータ基盤革新、パフォーマンスを向上しながら、運用負荷とコストを削減 11月11日 6:20 AIで開発が加速する時代、品質保証はどう変わる? Tricentisが示すAIエージェント活用の実像 11月9日 6:45 悪用までの猶予が「1分」に迫るフロンティアAI時代に開発と本番を貫く脆弱性管理が必要 10月29日 8:30 欧州CRA対応とSBOM運用。AI生成コードのOSS混入問題の対策とは ――スニペット単位で検出する「FossID」「Insignary Clarity」によるSBOM運用 9月16日 6:40 PostgreSQLからTiDBへ、稼働中SaaSで進める段階的DB移行の実践と再設計への展望 9月7日 6:30 機能安全開発におけるGoogleTestの活用を支援!「Parasoft C/C++test CT」で実現する効率化&AI連携 4月14日 6:30 【CNDW2025】Grafanaが明かす「オブザーバビリティの哲学」ー最小限の労力で実用的なインサイトを得るには 1月23日 6:30 【CNDW2025】プロダクト急増に備える基盤刷新 ーウェルスナビがECSからEKSへの移行で得た知見とは 1月15日 6:30 【CNDW2025】250環境を5人で運用、構築時間は30分に ーKINTOテクノロジーズが語るインフラ基盤組織の作り方 2025年12月18日 6:30 新たな自動化で熱視線! AIエージェントの「推論能力」を支える2つのコンポーネントとは? 2025年11月28日 6:30