Alıştırma - İlk çekme isteğinizi oluşturma

  • 6 dakika

Çekme isteği (PR) şablonunda veya CONTRIBUTING dosyasında yönergeler sağlandığında çekme isteğinin nasıl oluşturulduğunu öğrendiniz. Peki proje kuralları içinde bu yönergeleri ve belgeleri sunmamışsa ne yapacaksınız?

Değişikliklerinizi açıklama

İyi bir işleme iletisi ve sonrasında çekme isteği yazmak için şu yöntemlere uyun:

  • Git işleme iletisi konu satırınız aşağıdaki tümceyi tamamlamalıdır:
    • Uygulanırsa, bu işleme <your subject line here>.
  • Geniş zaman kullanarak değişikliğin kısa ve öz açıklamasını ekleyin. Örneğin, ekle'yi, eklenmiş veya ekler yerine kullanın.
  • Konu satırınızı 50 karakterle sınırlayın.
  • Büyük harfle başlayın ve sonuna nokta (.) koymayın.
  • Konu satırınızda emojileri veya @mention diğer GitHub kullanıcılarını kullanabilirsiniz, ancak tüm projelerin buna izin vermediğini veya bunu teşvik etmediğini unutmayın.

İletinizin ve çekme isteğinizin gövdesinde geniş zaman kullanmaya devam edin. Değişikliğin ardındaki sebebi de eklediğinizden emin olun. Yaptığınız değişikliği önceki davranışla karşılaştırın. Ne ve neden ile nasıl arasındaki farkı açıklamak için elinizdeki alanı kullanın.

İşleme iletiniz, göndermek üzere olduğunuz içerik kadar konunun özüne ilişkin olacaktır. Gözden geçirilmesi için küçük, yalıtılmış değişiklik kümeleri işleyin veya gönderin. Bu uygulama değişikliklerinizin projeye eklenme şansını da artırır.

Ayrıntı ekleme

Çekme isteğinizi göndermeden önce PR’nizi tamamlamanın yolları için kenar çubuğunu gözden geçirin. Proje ekibinin yapısını biliyorsanız Gözden Geçiriciler veya Atananlar seçeneklerini seçin. Kullanıcı belgelerinde, örneğin CONTRIBUTING.md dosyasında, etiketleri nasıl kullanacağınızla ilgili yönergeler olduğunda etiketler ekleyin. Etiketleri, neyi başarmaya çalıştığınıza ilişkin görsel bir ipucu olarak kullanabilirsiniz. Ayrıca bakımcı da bir veya birden fazla etiket ekleyebilir.

Tavsiye

Depoda bir CONTRIBUTING.md dosyası veya çekme isteği şablonu varsa, çekme isteğinizi doldururken bu dosyanın yönergelerini izleyin.

Bu Learn modülü için depoda kullandığımız etiketlerden bazıları şunlardır:

  • Hata (kırmızı): Bir şey çalışmıyor
  • Belgeler (mavi): Belgelere yönelik iyileştirmeler veya eklemeler
  • Yinelenen (gri renkte): Bu sorun veya pull_request zaten var
  • Geliştirme (camgöbeği): Yeni özellik veya istek

İsteğe bağlı olarak, başarıyla birleştirilen bir çekme talebinin ilgili sorunu kapatabileceği kenar çubuğunda sorunları bağlayabilirsiniz. Ayrıca aboneliğinizi iş parçacığındaki bildirimlere göre özelleştirebilirsiniz. Bazı PR'ler birçok yorum, inceleme ve CI/CD ile ilgili bildirimler alır. Aşağıdaki seçeneklerden birini belirleyebilirsiniz:

  • Abone değil: Yalnızca katıldığınızda veya etkileşimde bulunduğunuzda bildirim alın @mentioned
  • Abone Ol: Bu pull request için tüm bildirimleri al
  • Töre: Yalnızca seçtiğiniz olaylar için bildirim alın

Alıştırma

İlk Katkılar projesini kullanarak fork etme, kopyalama ve çekme isteği gönderme alıştırması yapın. İlk Katkılar projesi , "yeni başlayanların ilk katkılarını yapmalarına yol göstermeyi" amaçlıyor. Hem komut satırını hem de birkaç grafik kullanıcı arabirimini (GUI) kullanmak için kılavuzları vardır. Ayrıca projenin çeşitli diller için de desteği vardır. Translations klasörünü denetlemeyi unutmayın.

Önceki modülden alınan dersleri ve bunu aklınızda bulundurarak, şimdi daha önce açmış olduğunuz çekme isteğine dönün. İsterseniz izlediğiniz projenin çekme istekleri sekmesine de gidebilirsiniz. İyi bir konu satırının ne kadar fark yaratabileceğini görün. Çekme isteğini buna uygun olarak güncelleştirmeyi göz önünde bulundurun. Yaklaşık olarak projedeki değişikliğe ayırdığınız kadar bir süreyi PR’nizi yazmaya da ayırın. Çalışmalarınız, bakımcıların topluluk katkılarını kategorilere ayırıp önceliklendirmesine yardımcı olur.

Bonus: Microsoft'un Erişilebilirlik Yönergelerini ve Gereksinimlerini denetleyin. Özellikle, katkılarınızda engelli bireylere yönelik dil kullanmaktan kaçınmak için kullanıcı arabirimiyle etkileşimleri açıklama hakkındaki bilgilere bakın. Müşteriler ürünlerle etkileşim kurarken farklı giriş yöntemleri kullanır. Örneğin klavye, fare, dokunma, ses girişleri kullanabilirler. Her giriş yöntemine uyan genel fiiller kullanmak istersiniz. Örneğin, girişe özgü tıklama veya çekme yerine seçme özelliğini kullanın.