36

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

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

4

2 に答える 2

49

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

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

バグ#1234を修正

それ以外の

バグ#1234を修正しました

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

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

于 2012-12-13T13:56:43.383 に答える
15

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

  • コードベースに動作を変更するように命令するかのように、命令法の変更を記述します。たとえば、「[このパッチ]はxyzzyをfrotzに変更します」または「[I]xyzzyをfrotzに変更しました」 。

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

于 2012-12-13T14:07:42.720 に答える