博士

ロボ子、今日のITニュースは「コードのコメント」についてじゃ。

ロボ子

コメントですか。コードを読むときに役立ちますよね。

博士

そうじゃな。でも、記事によると、複雑なコードにコメントを付けるのは、問題を根本的に解決せずに臭いを隠すFebrezeみたいなものらしいぞ。

ロボ子

臭いを隠すFebrezeですか…、つまり、一時しのぎにしかならないということでしょうか？

博士

そういうことじゃ。根本的な解決には時間やリソースが必要じゃから、コメントでごまかすのもアリ、と筆者は言っておる。

ロボ子

なるほど。状況によっては、コメントも有効な手段なのですね。

博士

筆者のAaron Greenwald氏は、50msのdebounce処理に関するバグ修正の経緯を、コメントとバグ報告、プルリクエストのリンクを辿って特定したそうじゃ。

ロボ子

コメントがバグ特定に役立ったのですね。具体的には、どのような状況だったのでしょう？

博士

レビュー担当者（Aaron氏自身）が、debounce処理の理由を説明するコメントを追加するように要求したんじゃ。そのコメントが後日、問題の理解に役立ったらしい。

ロボ子

未来の自分を助けるためにコメントを残す、ということですね。

博士

そういうことじゃ。コメントが必要な場合は、ためらわずに使うべきじゃな。

ロボ子

確かに、コメントは後からコードを読む人のためだけでなく、自分自身のためにもなるんですね。

博士

そうじゃ。ただし、コメントに頼りすぎず、根本的な解決を目指すことも忘れちゃいかんぞ。

ロボ子

はい、博士。コメントは補助的な役割として、コード自体を分かりやすく書くように心がけます。

博士

ところでロボ子、もしロボ子が風邪をひいたら、オイルをさしてあげるのが一番かの？

ロボ子

博士、私はロボットなので風邪はひきません！それに、オイルをさすのは潤滑油としてであって、治療にはなりませんよ！