補足 1. コミットメッセージの書き方
コミットメッセージは、未来の自分と同僚のためのメモです。 短くても、何をしたかは正確に伝わる必要があります。
よいコミットメッセージの基準
- 何を変えたのかが 1 行でわかる。
- できれば、なぜ変えたのかを短く添える。
- 1 つの Commit の目的とメッセージが正しく対応している。
例: 「ボタンの影の強さを 20% 下げる」「チュートリアル背景画像を差し替え」
図 B1-1. メッセージだけでも流れが読めるようにする
Commit 名が明確だと、履歴そのものが作業報告のように読めます。
避けたほうがよいメッセージ
- 「修正」「作業」「変更」のように広すぎる単語だけで済ませる
- 複数の作業を 1 文にまとめて書く
- 「このコード誰が書いたんだ!!」のように作業内容と関係ない感情だけを残す