GitHub'daki belirli bir projeye katkıda bulunmak istiyorum . Ben Meli çatal bunu? Dal mı? Ne önerilir ve nasıl yapılır?

İdeal olarak:

1. Projeyi çatalla
2. Depoya bir veya daha fazla iyi yorumlanmış ve temiz taahhütte bulunun. Birden fazla parça veya özelliği değiştiriyorsanız, burada yeni bir şube oluşturabilirsiniz.
3. Github'un web arayüzünde bir çekme isteği gerçekleştirin .

yeni bir Özellik isteği ise, önce kodlamayı başlatmayın. Yeni özelliği tartışmak için bir sorun yayınlamayı unutmayın.

Özellik iyi tartışılıyorsa ve +1 veya proje sahibi onayladıysa, sorunu kendinize atayın, ardından yukarıdaki adımları uygulayın.

Bazı projeler çekme talebi sistemini kullanmaz. Kodunuzu tekrar projeye geri getirmenin en iyi yolu için yazar veya posta listesine başvurun.

Yann'ın cevabına eklemek için , bir projeyi çatalladıktan sonra, istediğiniz herhangi bir dalda (yeni bir tane veya orijinal projeden bir tane) geliştirebilirsiniz.

Hatırla:

• orijinal projeyi uzaktan ekleyin (farklı form ' origin', çünkü originkendi repo, çatalın sonucu olacak)
• katkıda bulunmak istediğiniz orijinal repo şubesinin üstüne dalınızı yeniden oluşturun.
  Çekme talebinizin hızlı ileri birleştirme ile sonuçlanması önemlidir.
  Örneğin bakınız:
  • " Orijinal Github veri havuzundan yeni güncellemeleri çatallı Github veri havuzuna çekin ".
  • " Github'da çatallı depo güncellemesi "
  • " Git güncellemeli çalışma çatalı "

Yan ve VonC'nin cevaplarına eklemek için, bu github'dan iyi bir kaynaktır: http://help.github.com/forking/

Ayrıca, "ortak çalışma" başlığı altındaki sağ kenar çubuğuna baktığınızdan emin olun.

Burada süreç boyunca size yol gösteren harika bir Railscast videosu var . Ayrıca, katkıda bulunurken, testler, alt modüller vb.

Bu screencast öncelikle Rails geliştiricilerine odaklanırken, bilgilerin çoğu herhangi bir açık kaynak projesine katkıda bulunmak için geçerlidir.

Github, bir projeyle işbirliği yapmanın birçok yoluna sahiptir. Çoğu proje kullanım modeli bir çekme talebi modelidir. İnsanların ilk GitHub çekme talebini yapmalarına yardımcı olmak için bir proje başlattım. İlk PR'nizi burada yapmak için uygulamalı öğreticiyi yapabilirsiniz

İş akışı aşağıdaki gibi basittir:

• Repoyu github'da çatalla
• Repo'yu makinenize kopyalayın
• Şube yapın ve gerekli değişiklikleri yapın
• GitHub'da değişikliklerinizi çatalınıza aktarın git push origin branch-name
• Bir Compare and pull requestdüğme görmek için GitHub'daki çatalınıza gidin
• Üzerine tıklayın ve gerekli ayrıntıları verin

lornajane'de süreci iyi açıklayan bir blog yazısı var: http://www.lornajane.net/posts/2010/contributing-to-projects-on-github

Teknik iş akışı

Aşağıdaki iş akışını öneririm:

1. Depoyu çatalla (GitHub web arayüzü üzerinden: "Çatal" düğmesi)
2. Çatallı deponuza URL'yi kopyalayın

3. Klonlama (komut satırında)

   git clone <url-from-your-workspace>

4. Yeni oluşturulan dizini girin ve bir şube oluşturun

   cd <directory> git checkout -b <branchname>

5. Şimdi değişikliklerinizi yapın

6. Her değişiklikten sonra bir veya daha fazla taahhüt oluşturabilirsiniz:

   commit -a

7. İşiniz bittiğinde değişikliklerinizi itin

   git push origin <branch>

8. Komut satırınızda, PR oluşturmak için bir URL görmelisiniz . URL'yi ziyaret edin ve bir PR oluşturmak için düğmeyi tıklayın.

9. Değilse, tarayıcıdaki havuzu ziyaret edin ve çekme isteğini oluşturmak için size bir düğme sunacaktır.

Bu kadar.

Yani, temel olarak, depoyu çalışma alanınıza çatalladınız, yeni bir şube oluşturdunuz ve o yeni dalı ittiniz.

Daha sonra aynı klonlanmış repodan daha fazla PR yaparsanız, başka bir PR için başka bir şube oluşturmadan önce senkronize etmelisiniz (orijinal depodaki en son değişiklikleri almalısınız):

git checkout master
git remote add upstream <url-of-original-repo>
git pull upstream master

Dikkat edilecek diğer noktalar:

• projenin Katkı Yönergeleri olabilir: CONTRIBUTING.rst veya .md dosyasını arayın
• proje için kodlama kurallarına uymak isteyebilirsiniz
• önce fikrinizi sorun olarak özetlemek isteyebilirsiniz
• proje için Çekme İstekleri sekmesine bakmak ve açık PR, birleştirilmiş PR olup olmadığını kontrol etmek isteyebilirsiniz

Bu öneriler sizi bir araya getirilmeyecek bir PR'ye çalışma zahmetinden kurtarmak için burada. Projede faaliyet varsa ve halkla ilişkiler birleştirilirse, bu iyi bir işarettir. Katkı İlkeleri varsa, bunları uygulayın.

Her zaman saygılı olun. Unutmayın, proje sahipleri hiçbir şekilde PR'nizi birleştirmek zorunda değildir. Projeye eklemek için değerli bir şey var mı?