手法別開発ドキュメントの書き方 1

開発ドキュメントと開発手法

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

Think IT編集部

2008年2月7日 20:00

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

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

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

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

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

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

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

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

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

この記事をシェアしてください

人気記事トップ10

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