ソフトウェア設計文書とは何ですか？

ソフトウェア設計文書は、ソフトウェアの仕様を概説し、開発者にロードマップを提供します。 ソフトウェアの開発プロセスの初期段階で作成され、状況やニーズの変化に応じて変更される場合があります。 このドキュメントは内部使用向けに設計されており、通常は設計チームやクライアントのオフィスの外部には配布されません。 場合によっては、抜粋が研究の一環として、または社外の人々とのコミュニケーションとして公開される場合があります。

ソフトウェア設計文書のコンポーネントは、製品が何を行うべきか、どのように行うべきかを概説しています。 これには、開発者が完成品に含める必要があるすべての機能とともに、プログラムの基盤となるアーキテクチャが含まれます。 ドキュメントでは、開発の段階を進むプログラマーにガイダンスを提供するために、グラフィカルインターフェイス、およびユーザーがプログラムと対話する方法について説明できます。

ソフトウェア設計文書の作成には、複数の担当者が関与する場合があります。 彼らは文書が完全であることを確認し、それがクライアントのニーズを正確に表していることを確認するために、さまざまなニーズと懸念について話し合います。 彼らの目標は、チームのメンバーが使用する単一の統一ガイドを作成することです。 これにより、開発プロセスの一貫性が確保されます。これは、機能を設計および実装するときに全員が同じ参照ドキュメントを使用しているためです。

ソフトウェアがどのように実行されるべきかを議論することに加えて、ソフトウェア設計文書はターゲットオーディエンスを明示的にカバーできます。 たとえば、科学機器のソフトウェア制御に取り組んでいる会社は、ユーザーがマシンに精通している科学者または技術者であると想定する場合があります。 これは、ユーザーが既にこれを知っている必要があるため、ソフトウェアに技術用語の簡略化やコントロールの機能に関する議論を含める必要がないことを意味します。

対照的に、ワードプロセッシング用に設計されたソフトウェアには、ワードプロセッシングとコンピューターに精通していないユーザー向けのドキュメントとガイドが必要な場合があります。 経験のある人にはすぐに使用できますが、機能について学習したり、チュートリアルを取得したり、特定のタスクのヘルプを求めたりする場合に使用できるモジュールがあります。 より技術的なプロジェクトのためにソフトウェア設計文書に設定されているパラメーターは、ソフトウェアのユーザーがこれを必要としないという議論に関するいくつかの文書とユーザーガイダンスを省略することを推奨する場合があります。それ。