Pull isteğini gözden geçir ve gönder

  • 5 dakika

Çekme isteği (PR), Bilginizi Learn platformuna alma biletinizdir. Bir birleştirme isteği oluşturdunuz, ancak henüz hedef deponun birleştirme isteği kuyruğuna gönderilmedi. Birçok açık kaynak projesinde olduğu gibi, yayımlamadan önce değişiklikleri doğrulamak için yapılan bir dizi denetim ve inceleme vardır.

Halkla İlişkilerin Anatomisi

Açık çekme isteğinin ekran görüntüsü.

PR, PR'yi oluşturan GitHub kullanıcısını, hedef depoyu ve PR'nin oluşturulduğu dalı gösterir. PR'ler üst kısımda aşağıdakiler de dahil olmak üzere çeşitli sekmeler içerir:

  • Konuşma sekmesi: Diğer ortak çalışanların açıklamalarını görüntüleyip yanıtlayabileceğiniz, derleme ve gözden geçirme işlemi boyunca bildirimlerin listesini görebileceğiniz ve eylemleri gerçekleştirmek için açıklama otomasyonunu kullanabileceğiniz bir pano.
  • İşlemeler sekmesi: Bu dalda yapılan değişikliklerin kaydı.
  • Dosyalar değiştirildi sekmesi: Çekme isteğindeki değiştirilen dosya(lar)ın önceki durumlarıyla karşılaştırılması.

Güncelleştirmelerin veya bildirimlerin göründüğü ve siz, gözden geçirenler ve diğer ortak çalışanlar arasındaki tartışmaların gerçekleştiği Konuşma sekmesine dikkat edin. Ayrıca, çekme isteğini onaylayıp birleştirmeye hazır olduğunu belirtmek veya süreci duraklatmanız gerekiyorsa ertelemek gibi eylemleri gerçekleştirmek için buraya hashtag yorumları ekleyebilirsiniz.

PR'ler genellikle statülerini belirtmek için etiketler taşır; örneğin, gözden geçirilmeye hazır olmayan taslak PR'ler için draft, yeni veya gözden geçirilmemiş PR'ler için do-not-merge kullanılır.

Doğrulama

Çekme isteğinizin hedef dalı ile birleştirilebilmesi için bir veya daha fazla çekme isteği doğrulama işleminden geçmesi gerekebilir. Pull isteği oluştur'u seçtikten sonra GitHub, deponuz için yapılandırılan kontrolleri çalıştırır. Doğrulama işlemi tamamlandığında sonuçlar Pull Request'te görünür.

Doğrulama işlemleri, önerilen değişikliklerin kapsamına ve hedef deponun kurallarına bağlı olarak değişir. PR'nizi gönderdikten sonra, aşağıdakilerden biri veya daha fazlası gerçekleşebilir:

  • Birleştirilebilirlik: Önce dalınızdaki önerilen değişikliklerin hedef dalla çakışıp çakışmadığını doğrulamak için bir temel GitHub birleştirilebilirlik testi gerçekleşir. PR bu testin başarısız olduğunu gösteriyorsa, işleme devam etmeden önce birleştirme çakışmasına neden olan içeriği çözmelisiniz.
  • Katkı Lisans Sözleşmesi (CLA): Genel bir depoya katkıda bulunuyorsanız ve Microsoft çalışanı değilseniz, önerilen değişikliklerin boyutuna bağlı olarak, bu depoya ilk kez bir çekme isteği (PR) gönderdiğinizde kısa bir CLA doldurmanız istenebilir. CLA aşaması tamamlandıktan sonra çekme isteğiniz (PR) işleme alınacaktır.
  • Etiketleme: Etiketler, çekme isteğinizin doğrulama iş akışından geçişi sırasında durumunu belirtmek için otomatik olarak uygulanır. Örneğin, yeni PR'ler, doğrulama, gözden geçirme ve onay aşamalarını henüz tamamlamadığını belirten do-not-merge etiketini otomatik olarak alabilir.
  • Doğrulama ve derleme: Otomatik denetimler, değişikliklerinizin doğrulama testlerini geçip geçmediğini onaylar. Doğrulama testleri uyarılar veya hatalar oluşturabilir ve birleştirilmeden önce çekme isteğinizdeki bir veya daha fazla dosyada değişiklik yapmanızı gerektirebilir. Doğrulama testi sonuçları, gözden geçirmeniz için çekme isteğinize açıklama olarak eklenir ve size e-postayla da gönderilebilir.
  • Hazırlama: Değişikliklerinizden etkilenen makale sayfaları, doğrulama ve derleme aşamasını başarıyla geçtikten sonra gözden geçirilmek üzere otomatik olarak bir hazırlama ortamına dağıtılır. Çekme isteği yorumlarında önizleme URL’leri görüntülenir.
  • Otomatik birleştirme: Doğrulama testini ve belirli ölçütleri geçerse çekme isteği otomatik olarak birleştirilebilir. Bu durumda, başka bir şey yapmanız gerekmez.

Gözden geçirme ve onay verme

Neredeyse oradasınız! Tüm çekme isteği işlemleri tamamlandıktan sonra, birleştirme öncesinde daha fazla değişiklik gerekip gerekmediğini belirlemek için sonuçları (örneğin, çekme isteği açıklamaları, önizleme URL'leri) gözden geçirmek en iyi uygulamadır. Bir PR gözden geçiren, PR'nizi gözden geçirmişse ve birleştirmeyi engelleyen sorular veya bekleyen sorunlar varsa, yorumlar aracılığıyla geri bildirim de sağlayabilir.

Çekme isteğinde önemli eylemleri gerçekleştirmek için açıklama otomasyonunu kullanın. Yorum otomasyonu, kullanıcıların çekme isteğine uygun etiketi atayarak durumunu güncellemesine veya kategorilere ayırmasına olanak tanır. Açıklama otomasyonunun uygulandığı bir depoda çalışıyorsanız etiket atamak veya değiştirmek, çekme isteğini kapatmak veya birleştirmeyi duraklatmak için hashtag açıklamalarını kullanın. Örneğin, değişiklik yapmayı bitirdiğinizde, PR etiketinizi #sign-off'den do-not-merge'ye değiştirmek için ready-for-review. açıklamasını yazarsınız.

Çekme isteğinizde önemli eylemleri gerçekleştirmek için aşağıdaki tabloda yer alan açıklamaları kullanın:

Hashtag yorumu Ne yapar?
#sign-off Depodaki gözden geçirenlere çekme isteğinin gözden geçirme/birleştirme için hazır olduğunu bildirmek amacıyla ready-to-merge etiketini otomatik olarak atar.

Listelenen yazar değilseniz ve #sign-off yorumu kullanarak genel bir depo çekme isteğinde oturumu kapatmayı denerseniz, çekme isteği, etiketi yalnızca yazarın atayabileceğini gösterecek şekilde güncellenir.
#hold-off Fikrinizi değiştirirseniz veya hata yaparsanız ready-to-merge etiketini kaldırır.
#please-close Değişiklikleri birleştirmemeye karar verirseniz, PR'yi kapatır.
#please-open Kapalı bir çekme isteğini (PR) veya sorunu yeniden açar.

Değişikliklerinizi birleştirmek için açıklamayı #sign-off girmeniz gerekir. Tüm incelemeler ve doğrulama denetimleri geçse bile, PR inceleyicilerine ve depo yöneticilerine değişikliklerinizin sizin tarafınızdan birleştirilmesi için hazır olduğunu bildirmek için bu açıklamayı kullanmak sizin sorumluluğunuzdadır. Gözden geçirenler çekme isteğinizin sorunsuz olduğunu ve onaylandığını belirlediğinde, değişiklikleriniz ana dalda birleştirilir ve çekme isteği kapatılır.

Bir PR'deki yorum kutusunun ekran görüntüsü; yorum alanına #sign-off yazılmış ve Yorum Yap düğmesi vurgulanmış.

Yayımlama

Değişikliklerin bir sonraki zamanlanmış yayımlama çalışmasında yer alması için çekme isteğinizin bir PR inceleyici tarafından birleştirilmesi gerektiğini unutmayın. Normalde PR'ler gönderim sırasına göre gözden geçirilir ve birleştirilir.

Katkılarınız onaylandıktan ve birleştirildikten sonra yayım süreci devreye girer. Katkıda bulunduğunuz depoyu yöneten takıma bağlı olarak yayımlama süreleri farklılık gösterebilir ancak genellikle haftanın her günü en az bir kez gerçekleşir. Makalelerin yayımlandıktan sonra çevrimiçi ortamda görünmesi 45 dakikaya kadar sürebilir.

Değişiklikleriniz yayımlandıktan sonra, başkalarının öğrenmeye başlaması için Microsoft Learn'de canlı yayına geçerler!

Senaryo: Değişiklikleri Azure Uygulaması Hizmeti'ne yayımlama

Geçmiş deneyiminizi kullanarak, App Service açıklama sayfasına bazı yararlı bilgiler ekleme fırsatı buldunuz ve değişikliklerinizi eklemek için bir PR oluşturup sundunuz. Artık düzenlemelerinizi yayımlamak için çekme isteğinizi gözden geçirmeye ve onaylamaya hazırsınız.