After seeing people use the @jetbrains UI to commit to git I understand where all those - sorry: shitty - commit messages come from…

🙈

An improvement would already be to have a “Subject” line and the text box.

And have the subject line follow the Beams Rule.

Sonthat the first line of the commit message finishes the sentence

“When this commit is applied it will…”

And please: No longer than 56(?) characters (Unicode). Keep it short. You got the textbox to explain *why* in full length.

  • Alerta! Alerta!@phpc.socialOP
    2·
    2 months ago

    @BatmanAoD And the commit message *is* documentation. It explains the “Why” making transparent why the code was written the way it is. If the commit message doesn’T reflect that, then you can also use git commit -m "Fixed issues"

    But again: That is then a people problem that no tech will solve!

    • BatmanAoD
      2·
      2 months ago

      My point is that “the comments aren’t accurate” is also a people problem. And I absolutely disagree that commit messages are “documentation” of anything except the development history.

      • Alerta! Alerta!@phpc.socialOP
        1·
        2 months ago

        @BatmanAoD Oh I am absolutely with you that commit messages document the development history.

        And there are valid cases for code-comments (I am a strong proponent of them) when they explain why something is solved in this specific way that would otherwise cause confusion when reading the code! But those tend to suffer from entropy 😁