はむはむエンジニアぶろぐ

365日エンジニアリング

2016-01-08から1日間の記事一覧

Whyについてコメントを書きHowについてコメントを書かない

ソースコード中のコメントは、我々を助けてくれることもあれば毒になることもある。 よかれと思ってコメントをかいたことが、後からメンテナンスする人を苦しめることにもなる。 例えばコメントの情報が誤っていたり、わかりにくい表現でコメントされている…