git taahhüt mesajları yazarken takip etmek için standart

Question

Kendimi çok fazla dosya (60'ın üzerinde ama 70'in altında) yönetiyorum ve şu ana kadar benim taahhüt mesajlarımı takip et: layout.css gibi bir şey eklediğimde, benim taahhüt mesajım "layout.css dosyasında bir şey ekledi" ve bir şeyi kaldırdığımda, benim taahhüt iletisim "layout.css dosyasından bir şey kaldırıldı". satır aşağı

Bazı dosyalar, benim onaylatabilirsiniz yem ve katma ... ve kaldırılan ... mesajlar hakim bak. Bazen neyi kaldırdığımı veya ne zaman eklediğimi hatırlamıyorum. layout.css'da çok fazla değişiklik yaptım ve bu yüzden uygun bir taahhütte bulunmaya çalışıyorum.

İletim mesajlarıma ulaşmama yardımcı olmak için takip etmem gereken bir standart var mı?

Answer 1

sadece yaptığına açıklar: Burada

konuda bazı ayrıntılı notlar "bir işlev ekledi"), Git'in zaten işlemde saklandığı şeylere fazla bir şey eklemiyorsunuz. Kendinizi bir süre sonra taahhüt mesajını okurken hayal edin; Diğer geliştiricilere en çok hatırladığınız/iletişim kurduğunuzda bu değişimin özüne ne tür bir özeti yardımcı olur ?! Kesin içerikler projenize ve süreçlerinize bağlıdır, ancak iyi bir kılavuz olduğunu düşünüyorum. sizin taahhüt mesajla nedenle

, öncelikle eklemek bağlam ( neden değil nasıl ) yerine "ilave Fröb() fonksiyonu") olarak (örneğin, "kalıcılığını sağlamak için mesaj frobnize"). Bu daha fazla çaba harcamalıdır (düşünün düşünün), ama çok daha fazlası.

Bu konuyla ilgili daha fazla bilgi edinmek isterseniz, this blog article by Peter Hutterer veya this funny slide gibi bir bilgi hazinesi var.

Answer 2

Git, bir tadilatta hangi dosyaları değiştirdiğinizi zaten biliyor, yorumda belirtmek gereksizdir. Sadece örneğin "sabit doldurma hatası" veya "kenar çubuğunda eklenmiş menü" deyin. Netleştirin, bu kadar.

Answer 3

50/72 modeli iyi bir uygulama gibi görünüyor. Yani ... ilk satır 50 karakter uzunluğunda olmalı ve bir başlık olarak sunucuya sahip olmalıdır. Bir boşluk ile takip edilen ikinci satır (lar) 72 karaktere sarılmalı ve bir özet olarak sunulmalıdır. İşte bir SO soru: Git Commit Messages : 50/72 Formatting, aynı şeyi tartışıyor. gibi teknik henüz bulanık açısından (

1. GIT Commit Good Practice
2. A Note About Git Commit Messages
3. Proper Git Commit Messages and an Elegant Git History