web-dev-qa-db-ja.com

現在形でgitcommitを説明するのが良い習慣と見なされるのはなぜですか?

私は公式のものを含むすべての種類のGitチュートリアルを読みましたが、それらはすべて、現在形でGitコミットノートを書くことは良い慣習と実践であると私に言っているようです。

何故ですか?その背後にある理由は何ですか?

34
Madara's Ghost

Gitは分散VCS(バージョン管理システム)です。複数の人が同じプロジェクトに取り組むことができます。多くのソースから変更を取得します。
コミッターが何をしたかを伝えるメッセージを書くのではなく。リポジトリでコミットが適用された後に何が行われるかについての指示としてこれらのメッセージを検討することをお勧めします。

だからこのようなメッセージを書く

バグ#1234を修正

の代わりに

バグ#1234を修正

Gitログは、アクションの履歴ではなく、すべてのコミットが実行するシーケンスの説明として扱います。

ハッカーニュース については大きなスレッドがあります。この慣習の背後には、さらに多くの理由があります。

44
Shiplu Mokaddim

これは(比較的)一般的な規則であるため、プロジェクト内のメッセージは一貫して読み取られます。 (たとえば)Gitにパッチを送信するためのアドバイスは Documentation/SubmittingPatches

  • 命令法の変化を説明します。コードベースに動作を変更するように命令するかのように、「[このパッチ]はxyzzyをfrotzにする」または「[I] xyzzyをfrotzに変更する」の代わりに「makexyzzydofrotz」。

括弧で囲まれた主語からわかるように、この規則により、有用な利点を提供しないコミット動詞の繰り返しの(または暗黙の)主語の必要性がなくなります。

13
CB Bailey