エントリーの編集
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています
コードはHOW、テストはWHAT、ドキュメントはWHY。 先日のソースコードリーディングワークショップ2010で... コードはHOW、テストはWHAT、ドキュメントはWHY。 先日のソースコードリーディングワークショップ2010でそんなようなことをお話した。 これは文字通りの意味だ。コードは実装の詳細HOWを表現している。どのように問題を解いたか。プログラマの数だけ表現がある。一方テストはWHATだ。何を実現するかを表している。そしてドキュメントはWHYを記す。このシステムが解決する問題とか、なぜこのシステムを開発しなければいけなかったかという魂のドキュメントだ。 WHYがあってWHATがあってそしてHOWがある。 何か解決したい問題、あるいは表現したものがあって、それをプログラムという形に落としこんで行くのがプログラマの仕事だ。 同じ機能を実装するにも、簡潔ですっきりしたコードから、冗長で散漫なコードまで千差万別である。コード量も少ない物から、無駄に長いもの、実行時間も速いのや遅いもの、保守性に富むもの