Bir projede yeni bir özellik hazırladınız ve onu ana dala almak istiyorsunuz. Dosyaları doğrudan ana dala göndermek yerine önce neyin değiştiğini görmek, testleri kontrol etmek ve gerektiğinde ekip arkadaşlarınızın görüşünü almak faydalı olabilir. GitHub'da pull request (PR), bir daldaki değişiklikleri başka bir dala birleştirmeyi öneren çalışma alanıdır.

Kod editörü ve dallanma şeması gösteren çalışma ortamı

Bu rehberde kendi deneme deponuzda, iletisim-sayfasi adlı bir dalın varsayılan dala alınmasını örnekleyeceğiz. Gerçek bir ekip projesinde dal adları, zorunlu kontroller ve birleştirme yetkileri farklı olabilir.

Pull request ne yapar, ne yapmaz?

Bir PR açtığınızda GitHub kaynak dal ile hedef dal arasındaki farkları gösterir ve bu değişiklikler üzerinde konuşma, inceleme ve kontroller için alan sunar. PR açmak tek başına değişikliği hedef dala birleştirmez. Bu ayrıca verilmesi gereken bir karardır.

PR bir dosyanın kopyasını e-posta ile göndermek gibi düşünülmemelidir. Aynı kaynak dala yeni commit gönderdiğinizde açık PR ilgili değişikliklerle güncellenir. Bu nedenle inceleme sırasında neyin değiştiğini ve hangi sürümün test edildiğini takip etmek önemlidir.

1. Ön koşulları kontrol edin

Deneme deponuzda varsayılan dalın yanında en az bir yeni commit içeren iletisim-sayfasi dalınız olsun. Bu dalı kendi GitHub deponuza göndermiş olun. GitHub'daki depo sayfasına giderek doğru hesapta ve doğru repoda olduğunuzu kontrol edin.

Özel bir depoda başkalarının PR'ı görebilmesi, o kişilerin depoya erişim yetkisine bağlıdır. “Bağlantıyı gönderdim, herkes açar” diye varsaymayın. Açık depodaki PR içeriğinin ise herkese açık olabileceğini unutmayın; parolaları, kişisel verileri ve gizli ekran görüntülerini açıklamaya koymayın.

2. Kaynak ve hedef yönünü doğru seçin

Repo sayfasındaki Pull requests bölümünden yeni PR oluşturma akışını açın. GitHub karşılaştırma ekranında genellikle iki temel seçim gösterir:

  • Base (hedef): Değişikliklerin alınması önerilen dal; örnekte varsayılan dal.
  • Compare / head (kaynak): Hazırladığınız değişiklikleri içeren dal; örnekte iletisim-sayfasi.

Bu yön karışırsa beklediğinizden farklı değişiklikler listelenebilir. İki dalı seçtikten sonra farkları okumadan devam etmeyin. İki dal arasında değişiklik yoksa PR açılacak bir fark bulunmadığını görebilirsiniz.

3. Açıklamayı okuyana göre yazın

PR başlığında sonucu somutlaştırın: “İletişim formuna doğrulama ekle” gibi. Açıklamada hangi sorunu çözdüğünüzü, önemli kararları ve neyi nasıl test ettiğinizi belirtin. Test etmediğiniz bir durumu test edilmiş gibi yazmayın.

Örnek kısa açıklama:

KOD
İletişim formunda boş e-posta gönderimini engeller.
Doğrulama mesajını masaüstü ve mobilde kontrol ettim.

Bu yalnızca bir örnektir; kendi PR'ınızda gerçekten yaptığınız değişikliği ve kontrolleri yazın. Henüz tamamlanmamış bir işi paylaşacaksanız GitHub'ın taslak PR seçeneğini değerlendirebilirsiniz.

4. Dosyaları ve kontrolleri inceleyin

Files changed bölümünde değişen satırları kontrol edin. Beklenmeyen bir .env, kişisel dosya veya büyük çıktı görürseniz devam etmeden önce durumu çözün. Otomatik testler yapılandırılmışsa Checks bölümünde sonuçlarına bakın. Yeşil bir kontrol yararlıdır ama her durumda uygulamanın hatasız olduğunu kanıtlamaz; testlerin neyi kapsadığını da anlamak gerekir.

Ekip kullanıyorsa inceleyici atayın ve geri bildirimleri değerlendirin. Bir yorum üzerine yeni commit yaparsanız inceleyicinin hangi değişikliği tekrar gözden geçirmesi gerektiğini açıklayın. İnceleme bir kişinin hatasını yakalama yarışından çok, değişikliği anlaşılır ve güvenilir hâle getirme sürecidir.

5. Birleştirmeden önce

Doğru hedef dal, beklenen dosyalar ve gerekli kontroller yerindeyse; yetkiniz ve projenin politikası da uygunsa birleştirme seçeneğini kullanabilirsiniz. Merge, squash veya rebase seçenekleri ekip geçmişini farklı biçimde etkileyebilir. Bu nedenle hangisinin doğru olduğunu projenin kuralları belirler.

Çakışma varsa veya test başarısızsa sırf düğme aktif diye birleştirmeyin. Değişikliklerin neden çatıştığını ve nasıl doğrulanacağını önce inceleyin. Birleştirmek, bir uygulamanın otomatik olarak canlıya alınacağı anlamına da her zaman gelmez; dağıtım akışı projeye bağlıdır.

PR'nin temel değeri basittir: değişikliği birleştirmeden önce ne yapıldığını görebileceğiniz, açıklayabileceğiniz ve kontrol edebileceğiniz ortak bir yer sağlaması.

Kaynaklar: GitHub: Pull request'ler · GitHub flow