プログラミングメモ日記 危険なコメント

Martin Fowler著「リファクタリング」 に、「危険なコードのにおい」について解説されています。 Robert. C. Martin著「CleanCode」 を少し前に読んだのですが、その中で上記について、まとめられた記述があり、それがわかりやすかったので少し紹介してみたいと思います。 上記は、コーディング全般に関する内容なのですが、特にコメントについては、普段良く見るアンチパターンについて説明されているので、今日はコメントについての部分だけ。 書籍では、下記の５点のようなコメントは書いてはならない、とされています。 以降、各項目について。 ・不適切な情報 ソースコード管理システムやバグトラッキングシステムで扱う情報をコメントにしてはならない。 更新履歴作者SPR(SoftwareProblemReport)番号 これらのような情報をコメントとしてコードに入れるべきではない。 ・退