Subversionに代表されるSCM(Source Code Management バージョン管理システム)にコミットする際に、 適当なコメントを書かれていて後で困ることが多々あります。 TracやRedmineなどBTSとチケット連携しているような場合は基本的には問題ないのですが、 そうではない場合は、コミットコメントの重要性をきちんと認識しておきたい(させておきたい)ところです。 自戒も込めて、コミットログに書くべきこと書いておきます。 # これはSubversion実践入門-達人プログラマに学ぶバージョン管理に書かれていることのコピーです。 ログのポリシーで書くべきこと このリビジョンにより解決される特定の問題の状態 なぜその問題の解決が必要だったのかの簡単な説明 既知の副作用のリスト 変更したインターフェースのリスト 削除したものがあれば、その説明 他の関連するリビジョンやタグへ

