タグ

templateと開発に関するshirotorabyakkoのブックマーク (1)

  • 意図が伝わる設計書作成の心得【第5回】

    仕様書の品質を均一化するためにテンプレートを利用する現場は多いと思うが,正しく運用できているだろうか。ちょっとした心がけの違いで,過剰品質の原因となったり,型にはまりすぎた平板な仕様書を生みだしたりする。「テンプレートの利用に伴う弊害」をテーマに取り上げ,よく起こる2タイプの事例を通して,予防するための心得とは何かを考えてみたい。 仕様書を作成する際,記述する情報の質と量が重要であることは言うまでもないが,その記述レベルは人によってばらつきやすい。特にシステムの規模が大きければ,仕様書の作成にかかわる人の数が増え,生み出される仕様書の質と量のばらつきも大きくなってくる。 このような問題を避けるため,書式や記述レベルを均一化する目的で仕様書の「テンプレート(ひな型)集」や「ガイドライン」を用意したり,プロジェクトの実情に合わせた「記述サンプル」を作って配布したりする開発現場は多いだろう。仕様

    意図が伝わる設計書作成の心得【第5回】
    shirotorabyakko
    shirotorabyakko 2006/11/01
    「後から参加する開発者や運用保守担当者にとって必要な資料」という基準
  • 1