仕様のドキュメント化に対する考え方

• 「ソースコードがドキュメント（＝だから仕様書なんて改めて書く必要ない）」という考え方は基本的にはありだと思う。
  • でも、今後メンテナンスする可能性が少しでもあるなら、「なぜこういう仕様にしたのか」の思想（根拠）は残しておくべき。
    • 形式は問わない。
    • じゃないと、あとで手をいれるときに困ることがあるかもしれない。