仕様書を意味があるものにするために気をつけるべき3つのこと - Qiita

前置き 長年、書いてはバインダに挟まれキャビネットの奥深くにしまわれるシステム仕様書を書いてきました。 単にハンコをつくための台紙にしかならない仕様書作成ほど、エンジニアのやる気を削ぐものはありません。だからこの業界では、仕様書不要論なんてあったりするんですよね。 でも、それは間違いです。不要なのは仕様書ではなく、使われない仕様書です。 使われる仕様書を書いてみんなで幸せになりましょう。 まず読む やさしい機能仕様 - Joel on Software http://japanese.joelonsoftware.com/Articles/PainlessFunctionalSpecifi-2.html 読んだ？ 大丈夫。長いけれど面白いのでするする読めます。 この知識が一番ベースになります。 で、読んだ？ はい。 読んだあなたには、仕様書が必要だということ、どのような仕様書を書けばそれが

[cloudliner_tweets]

「コードとの乖離がほんの5%程度になった時、そのドキュメントはもう信用ならないものになると感じます。なぜならウソが書いてあるからです。しかもどこがウソなのかわかりません」

[snowlong]

“機能仕様と技術仕様は厳密に分離する”