blogこの広告は、90日以上更新していないブログに表示しています。2016-03-15Javaのコメントの書き方の話ソースレビューしてたら先輩社員とコメントの書き方について揉めた意見の交換ができたので、その話。外注の方が、プロジェクトにアサインされて実装をお願いすることになったのですが、当然最初なので少し実装をしてもらったところでソースレビューを行いました。その時に、たまたま聞こえる範囲にいた先輩が覗きに来て、そのまま2人でレビューをしました。その中で、(色々とあるにはありますが中でも)特にコメントの書き方で意見が別れたので書いてみます。先輩すべての処理(行)にコメントを記述すべきだ。変数名やメソッド名などで処理の内容がわかるなら不要。設計書の変更を行う際にソースコードのどの位置を変更すればいいのかわからんくなるから。設計書の変更があった際にソース上のコメントを変更し忘れた際に、どっちを信じたらいいのかわからなくなる。不具合発生時などにそのコメントが役に立つこともある。ソースファイルはソースコード書くところであって、履歴はSVNのコミットログを使うべき。コメントのないコードは先輩(例外なく)糞。自分(読めるなら)美しい。先輩ソースを触る人間はPGだけじゃなくて、ソースが読めないSEやPMの場合だってある。その場合にコメント無しでどうやって修正などするんだ。自分コメントは実際に動作する処理とは無関係で、触らなきゃいけないのはソースそのもの。コメントが多いとその分ノイズとなって修正すべき箇所が見つけにくくなる。考察?お互い立場も違うので意見の相違はあるとは思うし、確かにソースが全く読めない人間からしたらコメントはあったほうがいいのかなぁ。月別アーカイブ参加グループプログラミングはてなブログをはじめよう!kam1nchuさんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。