「アジャイルならドキュメントを残さなくてOK」が根本的に間違っている理由ソフトウェア開発にまつわる10個の神話【第5回】

ソフトウェア開発を効率的に進めるための手法として「アジャイル」型開発が浸透している。一方で「正しいアジャイル型開発」に関する誤解が存在することも事実だ。何がどう間違っているのか。

2023年06月09日 09時15分 公開
[Cameron McKenzieTechTarget]

 ソフトウェア開発分野には、誤解に基づく複数の“神話”が存在する。そうした10個の神話のうち、今回はエンジニアの間で広がっている“誤った習慣”と、その真実をひも解く。

神話8「アジャイル型開発ではドキュメントを残さなくてもよい」

 小規模な変更を短期間のうちに繰り返すソフトウェア開発手法が「アジャイル」型開発だ。アジャイル型開発の中核的な考え方を示す言葉に「網羅的なドキュメントよりも、動くソフトウェアに価値を置く」(Working software over comprehensive documentation)がある。この言葉はいつの間にか「アジャイル型開発チームはドキュメントを作成しなくてもよい」という趣旨の神話に変わってしまった。

 アジャイル型開発は確かに「ドキュメントは少ないほどよい」という思想を持つ。それでもドキュメントは必要だ。全てのソフトウェア開発プロジェクトには、ソフトウェアをどのように開発するのかについて、主要な設計決定の根拠となるドキュメントが必要になる。加えてソフトウェアユーザーにはソフトウェアの使い方を説明するドキュメント、ヘルプデスク担当者にはソフトウェアに関するサポート方法を説明するドキュメントを用意する必要がある。

 「アジャイル型開発には、ドキュメントは必要ではない」――。こうした考え方は、誰の役にも立たない。


 第6回は、9つ目の神話を紹介する。

TechTarget発 エンジニア虎の巻

米国TechTargetの豊富な記事の中から、開発のノウハウや技術知識など、ITエンジニアの問題解決に役立つ情報を厳選してお届けします。

ITmedia マーケティング新着記事

news148.jpg

CNN幹部が語る、メディアビジネスにとってのAIのリスクと機会
生成AIがコンテンツを量産し、真偽の明らかでない情報があふれかえる中、メディアの価値...

news016.png

「サイト内検索」&「ライブチャット」売れ筋TOP5(2024年4月)
今週は、サイト内検索ツールとライブチャットの国内売れ筋TOP5をそれぞれ紹介します。

news115.jpg

コカ・コーラ流 生成AIをマーケティングに活用する方法(無料eBook)
生成AIがこれからのマーケティングをどう変えるのかは誰もが注目するテーマ。世界最先端...