ブックマーク / someiyoshino.info (1)

  • 「正しく書かれたソースコードにコメントは必要ない」なんて幻想だという話(補足編) - 土屋つかさの技術ブログは今か無しか

    前回書いた「「正しく書かれたソースコードにコメントは必要ない」なんて幻想だという話( http://d.hatena.ne.jp/t_tutiya/20170519/1495197904 )」は土屋のブログ記事にしては珍しくはてブやコメント、twitterで反響を幾つか頂きました。その中の幾つかを紹介します。分かっているとは思うけど、サンプルコードはJavaScriptを意識してますがてきとーです。 案1:マジックナンバーを定数化する MAX_OPAQUE = 1.0f //定数宣言のつもり if (alpha < MAX_OPAQUE){ //処理A } "1.0f"に意図を設定すればコメントが不要なのではないか説。うーん、これはちょっと難しいかな……。"MAX_OPAQUE"が正しい変数名だとは思えませんが、どんな名前にすれば意図が説明できるのかちょっと思いつきません。また、数式が複雑

    「正しく書かれたソースコードにコメントは必要ない」なんて幻想だという話(補足編) - 土屋つかさの技術ブログは今か無しか
    Error401
    Error401 2017/05/22
    『リーダブルコード』曰く、「ぼくたちからのアドバイスはこうだ。「コードを理解するのに役立つものなら何でもいい から書こう」これなら、WHATでもHOWでもWHYでも(あるいは3つ全部でも)書 ける。」
  • 1