【レポート】コメントドリブン開発 - コメントを書いてからコードを書くことの効能 | エンタープライズ | マイコミジャーナル

ソースコードにコメントを記載するべきか、どの程度コメントを入れるべきか、どういった内容を書くべきかはプログラミング普遍の議題であって、永遠に解決しない問題の1つのようなところがある。よく言われるのは、短く簡潔で、他人がそのコードを読んだ時に理解を助けるように「なぜ」そのコードをそのように書いてあるのかをコメントとして入れるべきということだ。理にかなっているし、もっとも無難な方法だ。 しかし逆にコメントを書かない方がいいとする考えもある。それはコードとコメントが必ずしも一致していないことがあるからだ。また最初は一致していても、コードに変更を加えていくうちにコメントと内容が一致しなくなり、コメントとコードの不一致が作業ミスの原因になるというものだ。これも一理ある。これを突き詰めれば、コメントをまったく書かなければデベロッパは大量のコードを追って読む必要があり、初期コストは高いかもしれないが結局

[hirokinko]

自分のコーディングスタイルも大体こんな感じ。ただし、コメント箇所の実装が完了したら消すかなぁ・・・残したら非常に見辛くなるだけだし。どちらかというとTODO的に使うかな。

[hidehish]

コメントを書いてからコードを書く手法

[SuiJackDo]

非プログラマから見ると極めて論理的なアプローチに見えた。企画書を書く際に、実際これに近いことをしている。コードはすぐ書けるがコメントが書けない場合、コードの存在理由を明確にすべき、に同意。

[AmaiSaeta]

やりたい事を整理したい時に似たようなことをやるなぁ。 | コメントが多くなるかどうかは1コメントでどれくらいの処理を記述するか、で調整できるんじゃ。

[moro]

そこでコメントを書くように可読性が高い文法で状態を記述できるRSp(ry

[moqada]

2~3行毎にコメントを書く。コードを書く前にそのコードの目的となぜそのように書くのかの理由を書く。

[hiro_y]

コメント駆動開発。必要なときもあると思う。

[o-cha]

コメントを大量に書くなんて。。。この人のソースは絶対読みたくないな

[wwolf]

んー…自分にはあまり合わないかも。

[rna]

直感的に書けない時、書くのに失敗して書き直すときはやってる。

[hiragisan]

特に新しい考えというわけではないと思うが。あまりにコメントが多いと読みにくそうだ

[lizy]

コメントというか文章と同じぐらいの分かりやすさ・表現力を持ったコードを書くのが理想

[nobusue]

コメントドリブン開発