Git ile küçük değişiklikleri düzenli yayımlamak

“Siteyi düzelt” çok geniş bir görevdir. “Mobil menüde taşmayı gider” veya “Konu başlıklarına uzunluk kontrolü ekle” daha iyi tanımlanır. Çalışmaya başlamadan önce beklenen davranışı yazın. Sorun varsa hangi ekran genişliğinde veya hangi girişle oluştuğunu not edin. Böylece bitiş ölçütünüz yalnızca kodun derlenmesi değil, belirli bir davranışın düzelmesidir. Ayrı amaçları aynı değişikliğe eklemek incelemeyi zorlaştırabilir.

GitHub Flow, ana daldan ayrı bir dal açıp değişiklikleri burada hazırlamayı temel alır. Dal adına görevi anlatan kısa bir isim verebilirsiniz. Daha önce açılmış bir göreviniz varsa yeni bir kopya oluşturmak yerine o çalışmanın durumunu kontrol edin. Güncel temel sürümle çalışmak çakışmaları azaltır; ancak başka birinin yerel değişikliklerini silerek temiz bir başlangıç yaratmaya çalışmayın. Paylaşılan ortamda dosya sahipliğine ve devam eden işlere dikkat edin.

Commit, belirli bir değişiklik grubunun kayıt noktasıdır. Mesajında sonucu açıklayın: “Mobil menü bağlantılarının satıra geçmesini düzelt” gibi. Her kayıtta bütün projeyi yeniden biçimlendirmek, asıl değişikliğin görünmesini zorlaştırır. Gizli anahtar, parola, müşteri belgesi veya yerel ortam dosyalarını yanlışlıkla eklemediğinizi kontrol edin. Bir dosyanın depoya girmemesi gerektiğini fark ettiyseniz yalnızca adını değiştirmek yeterli değildir; geçmişe eklenmiş hassas bilgiler için ayrıca işlem gerekebilir.

Bir pull request açıklamasında sorun, değişen davranış ve yapılan kontrol bulunmalıdır. “Çeşitli düzenlemeler” yerine somut bir örnek verin: “Dar ekranda son iki menü bağlantısı görünmüyordu; artık menü açılır alanda tamamını gösteriyor.” GitHub'ın inceleme araçları dosya ve satır bazında yorum yapmayı, onay vermeyi veya değişiklik istemeyi destekler. Açıklama, inceleyen kişinin konuşma geçmişini bilmeden karar vermesine yardım etmelidir.

Bir başlık metni için kapsamlı güvenlik testi yazmak gerekmez. Üye yetkilerini değiştirdiyseniz oturumsuz ve farklı yetkili kullanıcıları denemek gerekir. İlgili kontrolleri seçin ve sonucu kaydedin. Test yapılamadıysa “başarılı” demek yerine neyin doğrulanamadığını belirtin. Görünüm değişikliğini gerçekçi ekran boyutlarında inceleyin. Başarılı bir derleme, yanlış bir bağlantının veya erişim hatasının bulunmadığını tek başına kanıtlamaz.

Değişiklik kabul edilip ana dala alındığında yayın sürecinin gerçekten tamamlandığını kontrol edin. Kodun depoda bulunması ile kullanıcının yeni sürümü görmesi farklı aşamalar olabilir. Yayın adresini, ilgili sürümü ve varsa geri dönüş yöntemini kaydedin. Tamamlanan dalı temizlemek çalışma alanını anlaşılır tutar; inceleme ve commit geçmişi yine yararlıdır. Bir sonraki işe başlarken önceki işi açıklayan bu küçük kayıtlar, aynı sorunun yeniden araştırılmasını önler ve ekip içindeki bilgi paylaşımını kolaylaştırır.