私は公式のものを含むすべての種類のGitチュートリアルを読みましたが、それらはすべて、現在形でGitコミットノートを書くことは良い慣習と実践であると私に言っているようです。
何故ですか?その背後にある理由は何ですか?
Gitは分散VCS(バージョン管理システム)です。複数の人が同じプロジェクトに取り組むことができます。多くのソースから変更を取得します。
コミッターが何をしたかを伝えるメッセージを書くのではなく。リポジトリでコミットが適用された後に何が行われるかについての指示としてこれらのメッセージを検討することをお勧めします。
だからこのようなメッセージを書く
バグ#1234を修正
の代わりに
バグ#1234を修正
Gitログは、アクションの履歴ではなく、すべてのコミットが実行するシーケンスの説明として扱います。
ハッカーニュース については大きなスレッドがあります。この慣習の背後には、さらに多くの理由があります。
これは(比較的)一般的な規則であるため、プロジェクト内のメッセージは一貫して読み取られます。 (たとえば)Gitにパッチを送信するためのアドバイスは Documentation/SubmittingPatches
。
- 命令法の変化を説明します。コードベースに動作を変更するように命令するかのように、「[このパッチ]はxyzzyをfrotzにする」または「[I] xyzzyをfrotzに変更する」の代わりに「makexyzzydofrotz」。
括弧で囲まれた主語からわかるように、この規則により、有用な利点を提供しないコミット動詞の繰り返しの(または暗黙の)主語の必要性がなくなります。