システム保守を行っていて困ることの１つとして、「ソースのコメントが誤っている」がある。
みなさんは他の人がコーディングしたソースを読んでいて、コメントが誤っていることに
気づいたことは無いだろうか？
コメントなんて、見ないでロジックを解読していけば、処理が分かるから誤っていても
問題ないだろう、と思っていないか？
システム保守の断面では、他の人がコーディングしたソースを読む断面が多々発生する。
（設計書には書かれていない細かい処理を知る必要がある場合など）
システム保守でソースを読む場合、１分１秒を争う対応を求められて行うことが多い。
そのとき、コメントで何をしているのか書いている内容は、ものすごく重要になる。
コメントから、何を行っている処理か判別し、今知りたい箇所の辺りをつけてから
ロジックを読むこととなるため、コメントが誤っていると、混乱の元となる。
ただでさえ、急いでいるのにソースが正しいのか、コメントが正しいのか、考える必要を
求められてしまう。
なので、俺はコメントの誤りは不具合である、と言い切れる。
過去にソースコードレビューを行っていて、コメントが誤っていることを指摘したら
単体テスト済みだし、処理に誤りは無いのだから問題ないだろうとゴネられたことが
ある。
だが、突っ返してコメントの修正＆再テストをさせた。
システム保守を経験したことが無い人には、分からないことなんだろうなぁ～