タグ

ブックマーク / qiita.com/y-some (1)

  • エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita

    Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書(仕様書)」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、亀の甲より年の劫とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 稿のテーマは、「主に設計書を想定した、開発ドキュメントの書き方」です。 稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな(≒納品物になりえる)設計文書、です。 したがって、自社サービス開発よりも受託開発、アジャイルよりもウォータ

    エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita
    yuangao
    yuangao 2018/02/15
    用語の統一と造語をしないのは大事よね。特に委託先など社外に出て行く設計書やRFPとかだと尚更のこと。
  • 1