motsat https://blog.hatena.ne.jp/motsat/ motsatのブログ https://motsat.hatenablog.com/ ドキュメントはコードや会話での表現を補わなければならない プログラムは信じられるが、ドキュメントなんて限りなく信用ならんという話。 - ドキュメントどころか、プログラム内のコメントさえも同期されなくなることはよくある - プログラムならあいまいな所は無いし - 逆に、口頭でのやりとりやホワイトボードでのやりとりのほうが後に残らなくて無害 - コミュニケーションの媒体としてコードに頼ろうとすれば、クリーンで透過的にしようという気になれるし ただし、プログラムだけで仕様を伝えるのは限界がある - その場合のドキュメントは、「コードを補足するもの」にする - 実際の仕様をもろもろ書き出すわけじゃない… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fmotsat.hatenablog.com%2Fentry%2F2018%2F10%2F10%2F232036" title="エリック・エヴァンスのドメイン駆動設計を読んでいる ( 4 ) - motsatのブログ" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2018-10-10 23:20:36 rich https://motsat.hatenablog.com/entry/2018/10/10/232036 1.0 100%