2年目のペーペーが1年目のペーペーにアドバイスするよ - Qiita

はじめに エンジニアになってから1年がたち、4月からは新人の方たちも入ってきました。 新人のコードをレビューしていると「うわ〜これ自分もやっちゃってたな〜...」と思うことが度々あるので、新人のあなたが同じ過ちを犯さないで済むようにこの記事で紹介していきたいと思います。 ベテランのあなたは読まなくて大丈夫です。 書かなくてもいいコメントを「（自分が）分かりやすいから」と残しがち 結構あるあるなんじゃないでしょうか？ そもそもコメントは少ない方がいいですが、必要に応じて残す場合もありますよね。最初はこの「必要に応じて」がどのくらいのレベル感なのか掴めず、不要なコメントを量産している人は少なくないはず。 私もかつてはゴミコメント生産機でした。こんな具合に。 とは言っても最初はコメントを残すべきかどうかの判断がなかなか難しいかもしれません。 とりあえず、処理の内容をそのまま書いたようなコメントは