2013年12月16日のブックマーク (2件)

  • コメントの9割は無駄!~アンチプラクティスから学ぶ洗練されたコメントの書き方~ #code #コード|CodeIQ MAGAZINE

    コメントは基礎的で一般的なものでありながら、「どのようなことをコメントに残すか」は経験のあるプログラマにとっても難しいもの。 この記事では、アンチパターンコメントを見ながら、どのようなコメントを残すべきかについて説明します。 by 馬場美由紀 (CodeIQ中の人) コードは機械のために、コメントは人間のために? プログラミング言語を学ぶとき、コメントは最初に習う項目のひとつです。そして、プログラムであればコメントを含んでいることが普通です。ある研究によれば、ソースコードの平均19%がコメントだそうです。 コードを書くとき、私たちは機械とコミュニケーションを取ることを意識しています。機械はコードを認識してコンパイルしたり実行してくれます。解釈できなければ教えてくれます。プログラマは、コンパイラのためにデータ型を明示するコードを書いたりもします。 一方、コメントは人間とコミュニケーションする

    コメントの9割は無駄!~アンチプラクティスから学ぶ洗練されたコメントの書き方~ #code #コード|CodeIQ MAGAZINE
    caq
    caq 2013/12/16
    例示のマジックナンバはコメントでも良いような気がするな。WEEK=604800と定義するなら、HOUR=60*60, DAY=HOUR*24, WEEK=DAY*7とかまで徹底してほしい。まあ、どっちかってえとコーディング規約の話な気もする。チームで揃えよう。
  • ごはんが美味しくないという話

    4月に就職のため上京し、なんやかんやで10キロ痩せた。 その理由はご飯のまずさだ。 まずいというよりは臭いと言えばいいのか。 もちろん、ご飯を美味しくするために色々な努力をした。 調味料を実家から持ってきたり、購入する野菜の鮮度を調べるやり方をぐぐって買うようにしたり 浄水器を導入してみたり。しかし、大きな変化は無かった。 というか、味よりも臭さが気になっているので味の改善だけではどうしようもなかった。 そして、最近気づいた。水が圧倒的にまずい。まずいし臭い。 そして、その水で器を洗うことによって水の臭いが器に移っているようだった。 それ以来、どんなことで水を利用するにも浄水器を使っている。 3ヶ月は保つと書いてある浄水器のフィルターが1ヶ月で真っ黄色になってしまう。 こんな水を使いながら生きていかないといけないのかと暗い気持ちになったが、そのうちなれるのだろう。

    ごはんが美味しくないという話
    caq
    caq 2013/12/16
    ちっちゃな受水槽以外は、年1の清掃が義務付けられてる上に大抵の市区町村で水道局が検査してくれるから通報したほうが良いかもね。水道局が直結給水を推進してるのは、検査の手間を減らす意味もあると思ってる。