開発ドキュメントとは何か!?

開発ドキュメントとは何か!?

「開発ドキュメントとは、読んで字のごとく、開発のときに使うドキュメントです!」

得意満面な笑顔で答えるA奈。

「そのドキュメントには何が書かれているかしら?」

「はい。顧客の要望やシステムの設計、仕様などが書かれています」

A奈は「えっへん」と胸をはった。それをみても表情を変えずにB乃が続ける。

「では何のために書くのかしら?」

「はい! 開発に使うためです!」

「…開発に使うのは、『開発ドキュメント』っていうくらいだから当然ね。じゃぁ開発中に、どういうところで使うか説明してごらんなさい」

「え〜っと、え〜っと、開発するときにプログラマの人たちが内容を確認します」

「それもあるわね。では他には?」

「え? ほかにですか? え〜っと…プロジェクトマネージャの人も内容を確認します」

「…さっきの答えとあまり変わらないわね。じゃぁヒント、システム開発に関係しているのは開発する側の人たちだけ?」

「開発するんだから、開発する人たちがいますよね…。他に、他に…」

「わからないかしら? もう一度学校に戻って教養からやり直す?」

「いえ、あそこはもう嫌です!(がくがくぶるぶる)」

「じゃぁ、もうちょっと考えてごらんなさい」

「え〜っと、え〜っと…。あ! システム開発を発注する人です!」

「そうね、開発ドキュメントが必要になる人は、開発する側だけじゃなくて、開発を依頼する側にもいるのを忘れちゃだめよ」

「は〜い」


死屍累々の現場に、何が足りない?

「さて、開発ドキュメントが必要な人がわかったところで、この現場をよくみてみましょう」

A奈は屍のようなプログラマでいっぱいの開発室の中を見渡した。各自の机の上にはさまざまな書類のプリントアウトがあり、それ以外にもモニタ上に数多くのドキュメントが開かれている。

「みなさん、いろんなドキュメントを持ってますね」

「そうね。とっても多くのドキュメントが散らばってるようにみえるわね。それぞれには何が書いてあるかしら」

「… そうですね、ほとんどがメールか、メールのプリントアウトみたいです。『この機能を入れてほしい』とか『あそこの仕様が変わりました』とか、あ〜こっちに は『あの機能は入れないことになりましたので、仕様は○日にメールしたものに戻してください』とかとか。あ、こっちの人は1日前のメールのプリントアウト を見てるけど、こっちの人は今日のメールを見てます。同じ箇所の仕様なのにどっちも違う内容だ〜」

「そう。ドキュメントはたくさんあるけれど、まったくまとめられていなくて、作業がいったりきたりしている状態ね。これじゃ手戻りが多すぎて、いくら徹夜をしても終わるわけがないわ」

「ほんとにそうですね。なんでこんな状況になってるのかしら」

「…だから、私たち、開発ドキュメントの妖精の力が必要なのよ」

人気記事トップ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