第1回:標準化と再利用 (1/3)

XMLで開発ドキュメント

【楽々デブドックを書こう!】XMLで開発ドキュメント

第1回:標準化と再利用

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

公開日:2008/02/06(水)

開発ドキュメントの重要性

2008年2月の特集はシステム開発の土台となる「開発ドキュメント」に焦点をあてている。

近年では開発関わるドキュメントがなければ、システム開発はうまく回らなくなりつつある。大規模化するシステム開発においては、ユーザの情報システム部門や利用ユーザ、システムインテグレータ、コンサルタントなど、多くの人々がかかわってくる。ユーザからの要望や、システム開発を行う側での情報の伝達、ユーザ企業とシステム開発側との意識合わせのために、さまざまな開発ドキュメントが必要である。

また、システム開発においては、最終的な成果物が正常に動作し、当初の目的を達成しているかどうかが重要である。成果物が納品できないことは論外であるが、目的が達成できなければ成果物ができたとしても使われない無用の長物ができあががってしまうこともある。最終的な成果物だけでなく、システム開発側の内部でのやり取りについても同じことがいえよう。

その時にドキュメントがあれば、その成果物に対する評価をすることができる。生まれるべくして生まれたのか、どこかでミスが発生したのかなどを検証することも可能だ。そのような理由から、開発にかかわるドキュメントは重要性を増してきている。

  • 開発の目的の明確化
  • 意識のズレの確認や情報伝達の手段
  • 情報共有の媒体
  • 成果物の評価

表1:開発ドキュメントの重要性

開発ドキュメントに用いられるツール

さて、これらのドキュメントを書くにあたっては、さまざまなツールを用いることとなる。主にWordやEcxel、PowerPoint、Visioなどを用いている方が多いだろう。実際に、火曜日の特集記事「ドキュメント作成の技」ではThink ITの読者アンケートの結果を紹介しているので参考にしていただきたい。

これらのドキュメント作成に用いられるツールは大変便利で、機能もそろっており、効率的に作業を進めることができる。またそれぞれのツールごとにメリットとデメリットがある。そのため、その時々でツールを使い分けている。確かに文書作成にはWord、計算式が多い場合はEcxel、見せ方ではPowerPointなど、得手不得手というものがある。その使い分けによって、ドキュメント作成の効率化をはかることができ、最終的には開発の生産性向上にもつながる。そしてこれらは個人や企業のノウハウとして蓄積されている

その一方で「開発ドキュメントの標準化」という考え方がある。 次のページ



INDEX
第1回:標準化と再利用
開発ドキュメントの重要性
 開発ドキュメントの標準化
 開発ドキュメントの管理
【楽々デブドックを書こう!】XMLで開発ドキュメント
第1回標準化と再利用
第2回情報システムにXMLが求められる背景
第3回情報システムの仕様をXMLで記述する!
第4回XMLの出力環境

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