hyoshiok https://blog.hatena.ne.jp/hyoshiok/ 未来のいつか/hyoshiokの日記 https://hyoshiok.hatenablog.com/ コードはHOW、テストはWHAT、ドキュメントはWHY。 先日のソースコードリーディングワークショップ2010でそんなようなことをお話した。これは文字通りの意味だ。コードは実装の詳細HOWを表現している。どのように問題を解いたか。プログラマの数だけ表現がある。一方テストはWHATだ。何を実現するかを表している。そしてドキュメントはWHYを記す。このシステムが解決する問題とか、なぜこのシステムを開発しなければいけなかったかという魂のドキュメントだ。WHYがあってWHATがあってそしてHOWがある。何か解決したい問題、あるいは表現したものがあって、それをプログラムという形に落としこんで行くのがプロ… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fhyoshiok.hatenablog.com%2Fentry%2F20100320%2Fp1" title=" コードはHOW、テストはWHAT、ドキュメントはWHY - 未来のいつか/hyoshiokの日記" 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 2010-03-20 00:00:01 rich https://hyoshiok.hatenablog.com/entry/20100320/p1 1.0 100%