Aracılığıyla paylaş

GitHub'da açık çekme isteklerini gözden geçirme

  • Makale

Bu makalede, çekme isteklerini (PR) gözden geçirip yorumlarınızı ekleyerek Microsoft Learn'e nasıl katkıda bulunabileceğiniz açıklanmaktadır. Genel GitHub deposunun açık çekme isteği kuyruğunu denetleyerek yeni konuları okuyabilir ve önerilen güncelleştirmeleri yayımlanmadan önce görebilirsiniz. Önerilen güncelleştirmelerde topluluk geri bildirimi, tüm topluluğa yardımcı olur.

Çekme isteği yorumları ve incelemeleri ile şunları yapabilirsiniz:

  • Çekme isteğindeki açıklamaları ekleyin ve yanıtlayın.
  • , ❤️ ve 🎉 gibi 👍emojilerle yorumlara tepki verme.

Önkoşullar

Çekme isteği bulma

  1. Tarayıcınızda, GitHub'da gözden geçirmek istediğiniz depoya gidin. Hangi depoya bakacağınızı emin değilseniz, Microsoft Learn depoları listemizde ilginizi çeken bir depo bulun.

    Belgelere göz atıyorsanız ve hangi depoya ait olduğunu bilmiyorsanız, sayfanın üst kısmındaki Kalem düzenle simgesini seçin. Bu eylem sizi GitHub'da kaynak dosyaya götürür. Depo adı, sayfanın sol üst köşesinde görüntülenir. Örneğin, aşağıdaki görüntüde deponun depo adı konumu gösterilmektedir azure-dev-docs .

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Bu deponun açık PR'lerini görmek için Çekme istekleri sekmesini seçin. Depoda çok fazla PR varsa etikete, yazara ve daha fazlasına göre filtrelemek için Filtreler çubuğunu kullanın. Belirli sorguları aramak için Arama çubuğunu da kullanabilirsiniz.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Başlık bağlantısını seçerek bir çekme isteği açın.

Çekme isteğini gözden geçirme

  1. Gözden geçirmekte olduğunuz çekme isteğinde Dosyalar değiştirildi sekmesini seçin.

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Özgün belgeyi düzenlenen belgeyle karşılaştırın. Özgün belge kırmızı, önerilen belge ise yeşil renkte olacaktır. Eklenen tüm metinler yeşil (yeni) bölümde vurgulanır ve silinen tüm metinler kırmızı (özgün) bölümde vurgulanır.

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Açıklama eklemek istediğiniz satırın sol tarafındaki artı (+) simgesini seçerek açıklama ekleyin veya değişiklik önerin. Birden çok satır seçmek için artı işaretini seçip sürükleyin.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Yalnızca geçerli çekme isteğinde düzenlenmiş satırlara açıklama veya öneri ekleyebilirsiniz. Başka değişiklikler yapmak için bu dosyayı kendi çekme isteğinizde düzenleyin.

  4. Bir kutu açılır. Yorumlarınızı veya sorularınızı oraya girin. İsterseniz, metninizi biçimlendirmek, madde işaretli ve numaralandırılmış listeler eklemek veya kod blokları ve görüntüler eklemek için araç çubuğundaki düğmeleri kullanabilirsiniz.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Ayrıca, bu satırdaki metinde değişiklik önerebilirsiniz.

    1. Açıklamanın araç çubuğunda simgeyi +- seçin (büyük olasılıkla en soldaki simge). Bu, Öneri ekle düğmesidir.

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. Seçtiğiniz satırdaki metin bir kod bloğuna (iki ''' arka uç kümesi içinde) eklenir.

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Üç çizgili kod çiti ('''' içeren metinlerde değişiklik önermek için, dış/kapalı suggestion arka uçları tilde (~~~) ile değiştirin.

    3. Metni düzenleyin. Kalın, italik ve madde işaretleri gibi basit biçimlendirmeler için açıklama kutusundaki düğmeleri veya doğrudan Markdown söz dizimi öğelerini kullanın. Kod bloğu bölümünün altındaki bu kutuya açıklamalar da ekleyebilirsiniz.

  6. Yorumunuzu yaptıktan sonra Gözden geçirme başlat'ı seçin. Çekme isteği yazarına değişiklikleriniz bildirilir. Önceki adımda Öneri ekle düğmesini kullandıysanız, yazar önerinizi doğrudan belgeye işleyebilir.

    Konuşmaya başka birini eklemek istiyorsanız, diğer katkıda bulunanları açıklamalarınızdaki GitHub diğer adlarıyla @mention. Bahsedilen GitHub kullanıcıları yorumunuzu içeren bir e-posta alır. Açıklamalarınızda Markdown'ı da kullanabilirsiniz ve yorumunuzu gönderdikten sonra yorumunuzun Markdown'ı işlenir.

  7. Konuşmalar sekmesinde açıklamaları okuyun. Sorularınız veya yorumlarınız varsa bunları konuşmaya ekleyin. Ayrıca, her yorumun sol alt köşesindeki gülen yüz simgesini seçerek yorumlara tepki ekleyebilirsiniz.

Gözden geçirme gönderme

Tüm yorumlarınızı incelemeye ekledikten sonra gözden geçirmenizi gönderin.

  1. Değişiklikleri gözden geçir iletişim kutusunu açmak için Dosyalar değiştirildi sekmesinin sağ üst kısmındaki Değişiklikleri gözden geçir düğmesini seçin.
  2. Açıklayıcı bir Gözden Geçirme özeti girin.
  3. İstediğiniz gözden geçirme türü için radyo düğmesini seçin ve ardından Gözden geçirmeyi gönder'i seçin.

Submitting a review in GitHub.

Çekme isteği yazarı, incelemenin bildirimini alır.

Sonraki adımlar

Yorum ve incelemeler hakkında daha fazla bilgi edinmek için GitHub belgelerindeki bu makalelere göz atın.