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

土屋はプログラマの中でもかなりコメントが多いタイプだと思っています。理想を言えばコード１行ごとにコメントを書きたいくらいです（本当は、識別子を全部日本語で書きたいと思っているのですが、これはまた別の話）。 これは土屋がPDL（Program Design Language https://www.gamedev.net/resources/_/technical/general-progra... ）開発スタイルの薫陶を受けているからなのですが、それとは別に「そもそも日本人には英語ベースのソースコードを高速に読解するのは無理がある」と考えているからです。 また、より本質的な課題があると思っていて、プログラミング業界的には「コードがドキュメントであるべき（≒正しく実装されたコードであれば、コメントは最低限になる）」という風潮がありますが、土屋は、これはプログラマが夢見る幻想に過ぎず、「本質的

[t_tutiya]

続きを書いたから読んでね読んでね（ http://d.hatena.ne.jp/t_tutiya/20170520/1495244763 ）。しかし「条件式をメソッド化する」派が多いけど、真偽値を返す１行だけのメソッドって実務でホントに書くの？　という疑問があります。

[sonots]

この例だったら、フェードインが未完了であることを示す変数、ないしは関数名を用意しろって言ってるだろ！！

[reteria]

「真偽値を返す１行だけのメソッドって実務でホントに書くの？」 書くんだよ。ドメインモデル貧血症だ

[ono_matope]

フェードインが未完了かを示すメソッドを実装する派が多いが待ってほしい。alpha<1.0 に名前をつけるならisTransparent(透過しているか)が適切。するとフェードインの文脈で使うにはやはりコメントが必要と思う。

[wwolf]

主張そのものには同意するけど、例示された状況ならフェードイン完了判定メソッドを作って、一々コメントは書かない方がよい（DRY原則を守るため）/同じ事めっちゃ書かれてたわ

[vanbraam]

自分は必ずしもコメント不要原理主義には与しないが,この程度の反例では一蹴されるのは他ブコメの通り;そもそも"英語云々"言ってる段階で,そのprogrammerにはprogramming言語という非native言語を使う資格がないと思う

[Inaab]

続きも読んだけど、このコードの前後も読んでわからないならコメントなりメソッドなり説明変数用意するべきだと思う。何のクラス、何のメソッドの中か、みたいなコードの文脈で分かればいらないのでは。

[suginoy]

主張自体には同意するが、この例だと条件式に適切な抽象度の名前が付けられないか検討すべき箇所

[reachout]

変数名が良くない長くても良いから何の変数かわかるようにしよう

[samu_i]

日本語の問題

[ttskch]

この例だとフェードインが未完了かどうかの判定をモジュール化してif文からマジックナンバー追い出してコメント消したくなる

[imo_jo_chu]

前こんな記事を書きました。　http://nzmoyasystem.hatenablog.com/entry/no_comment_culture

[goronehakaba]

たちまちあふれる 神秘の力♪ってコメント書けばいいよ

[Mash]

とはいえ少ないに越したことはなく

[barelo]

1.0fのリテラルに適切に名前をつけたらよいのでは。長い名前になりそうだけど。