先日Twitterにこんなことを書いた。 なにやってるかはコード見ればわかる。なにやろうとしてるかはコードみてもわからんからコメント書け。 そうしたところ、変数・関数(メソッド)に適切な名前をつければ改めてコメントの必要はないんじゃないかという指摘をうけた。 そんで、しばらくやりとりをしたのだけど、その中で結論として変数名・関数名やコメントで表現する内容が違うということに気づいた。 やはり、変数名・関数名には、その機能を表すものをつけることになる。一方で、コメントにソースコードで表されていることを書くのは意味がない。 if(a==0){ //aが0のとき } のようなコメントは、意味のないコメントとしてよく例にあげられる。 if(a==0){ //パラメータが渡されなかったとき } のように、判定の意図を書くべきだ。 ここで、変数をaじゃなくてまともな名前にすればいいんじゃないかという話で

東急ハンズの長谷川さんがブログで印象深いエントリを書いていた。 東京渋谷: 成長のためには、リセットが必要だ。幼稚園、小学校、中学、高校、大学と「新米」と「最年長」を５回くりかえす。問題は、社会人になって、このサイクルが、１回しかないことだ。 大学４年生は、大学１年生をつかまえて、「子供だな〜」なんて、いうけど、社会人になったら、ペコペコだ。 社会になっても、このシステムがあれば、もっと、よい組織であり、会社になると思う。 私は、何歳であろうとも、役職がなんであろうとも、自分がなんていう会社に勤めていようとも 「フラットでいること」 が大切なんだなと思っている。 東京渋谷: 成長のためには、リセットが必要だ。幼稚園、小学校、中学、高校、大学と「新米」と「最年長」を５回くりかえす。問題は、社会人になって、このサイクルが、１回しかないことだ。 以前、「初心者であり続けること」というエントリを書