Englisches Wörterbuch für gute Git-Commit-Messages

„Die Commit-Messages, die tatsächlich in Projekten verwendet werden, sind denkbar einfach. Auch die Grammatik liegt auf dem Niveau von Schulenglisch, und schwierige Wörter werden ebenfalls nicht verwendet. Letztlich sollte man das Schreiben von Commit-Log-Messages nicht als Verfassen von Texten, sondern als Arbeit mit Mustern angehen. Man ordnet die Merkmale des eigenen Commits einem Muster zu und wählt daraus die passenden Wörter aus. Betrachtet man das Ergebnis als Schreibstil, wirkt es vielleicht zu schlicht und unzureichend, aber damit es von vielen Menschen leicht gelesen und verstanden werden kann, sind standardisierte einfache Sätze deutlich besser.

Trotzdem ist es schwierig, Commit-Messages leicht zu schreiben. Erstens ist es schon nicht einfach, die Arbeit so in Commits aufzuteilen, dass sie sich jeweils in einem Satz erklären lässt. Zweitens muss man einen Satz formulieren, den eine unbeteiligte dritte Person, die ihn zum ersten Mal sieht, verstehen kann. Nachdem Sie commit -m eingegeben haben und das Eingabefenster für die Message erscheint, schließen Sie die Augen, atmen einmal tief durch und blicken auf Ihre Arbeit zurück. Wählen Sie dann das bestmögliche einzelne Wort aus.“