GitHub çekme isteği nasıl yapılır

GitHub'da barındırılan başka bir veri havuzuna nasıl bir çekme isteği oluşturur ve / veya gönderirim?

(Resmi " GitHub Yardım 'Çekme isteklerini kullanma' sayfasına " ek olarak
ayrıca bkz. " GitHub'da Çatallama ve Dallanma ", " GitHub'da başlangıç ​​noktası ve yukarı akış arasındaki fark nedir ")

Çekme isteklerinde çift ipuçları:

Bir repoyu ilk kez çatalladığınızı varsayarsak, sahip olduğunuz çatalda yapmanız gerekenler:

• bir şube oluşturun: bir şubedeki değişikliklerinizi izole edin. Birden fazla değişikliği aynı anda masterbiriktirip karıştırabileceğiniz bir çekme isteği oluşturmayın .
• bu şubeyi yeniden oluştur: bu şubeden bir çekme isteği yapmış olsanız bile, üstüne yeniden basmak origin/master( yamanızın hala çalıştığından emin olmak) çekme isteğini otomatik olarak güncelleyecektir (hiçbir şeyi tıklamanıza gerek yoktur)
• bu dalı güncelleyin : çekme isteğiniz reddedilirse, yeni taahhütler ekleyebilir ve / veya geçmişinizi tamamen yeniden yapabilirsiniz: mevcut çekme isteğinizi tekrar etkinleştirir.
• o dalı "odakla" : yani, konusunu "sıkı" yapın, binlerce sınıfı ve tüm uygulamayı değiştirmeyin, yalnızca iyi tanımlanmış bir özelliği ekleyin veya düzeltin , değişiklikleri küçük tutun .
• o dalı silme : kabul edildikten sonra çataldan (ve git remote prune origin) o dalı güvenle silebilirsiniz . GitHub GUI, çekme isteği sayfanızdaki şubenizi silmenizi önerir.

Not: Çekme İsteğinin kendisini yazmak için bkz. " Mükemmel çekme isteği nasıl yazılır " (Ocak 2015, GitHub)

Mart 2016: Yeni PR birleştirme düğmesi seçeneği: bkz. " İnceleme yorumları sonrasında çekme isteği üzerine Github squash web arayüzünden çalışıyor mu? ".

Repoyu sürdüren kişi merge --squashbu PR taahhütlerini seçebilir .

Çekme Talebinden Sonra

Son nokta ile ilgili olarak, 10 Nisan 2013'ten bu yana, " Yeniden tasarlanan birleştirme düğmesi ", şube sizin için silinir:

Birleştirme işleminden sonra şubeleri silmek de basitleştirilmiştir.
Silme işlemini fazladan bir adımla onaylamak yerine, sildiğinizde dalı hemen kaldırır ve yeniden ihtiyaç duyduğunuzda dalı geri yüklemek için uygun bir bağlantı sağlarız .

Bu, bir çekme isteğini birleştirdikten sonra dalı silme konusunda en iyi uygulamayı doğrular.

istek-istek ve istek-çekme

• çekme isteği resmi bir "git" terimi değildir.
  Git,request-pull birleştirme isteği oluşturmak için (!) Komutunu kullanır :
  "Standart çıktıya iki taahhüt arasındaki değişiklikleri özetler ve verilen URL'yi oluşturulan özete ekler."
  Github, ilk günden beri kendi versiyonunu (Şubat 2008) piyasaya sürdü , ancak Mayıs 2010'da bu özelliği yeniden tasarladı :

  Pull Request = Compare View + Issues + Commit comments
  

"depo" için e-notlar (sic)

<humour>

Bu (çekme isteği) GitHub tarafından düzgün bir şekilde tanımlanmamıştır!

Neyse ki, gerçek bir iş haberleri organizasyonu bilir ve pull-replace'i 'e-note' ile değiştirmek için bir e-not vardır :

Senin repo Yani o tory bir e-nota ihtiyacı ... Fox Business sormak . Onlar biliyorlar.

</humour>

Çekme talebinin nasıl yapılacağını öğrenmek için Github'daki iki ayrı yardım sayfasını takip ettim (aşağıda madde işaretleri olarak bağlantılı). Aşağıdaki komut satırı komutları Bölüm 1 içindir . Asıl çekme talebi olan Bölüm 2 , tamamen Github'un web sitesinde yapılır.

$ git clone https://github.com/tim-peterson/dwolla-php.git
$ cd dwolla-php
$ git remote add upstream https://github.com/Dwolla/dwolla-php.git
$ git fetch upstream
// make your changes to this newly cloned, local repo 
$ git add .
$ git commit -m '1st commit to dwolla'
$ git push origin master

• Bölüm 1 : Birinin Reposunu Çatalla: https://help.github.com/articles/fork-a-repo

  1. katkıda bulunmak istediğiniz repodaki 'çatal' düğmesini tıklayın, bu durumda: Dwolla'nın PHP repou (Dwolla / dwolla-php)
  2. bu durumda yeni oluşturulan çatalınızın URL'sini alın: https://github.com/tim-peterson/dwolla-php.git (tim-peterson / dwolla-php)
  3. yaz git clone->cd dwolla-php->git remote->git fetchçatalınızı bilgisayarınızda bir yere klonlamak için yukarıdaki diziyi (yani, bu örnekte "kopyala / yapıştır" third_party TimPeterson$) : ve ana repo ile senkronize edin (Dwolla / dwolla-php)
  4. yerel repoda değişiklik yap
  5. git add->git commit->git pushdeğişikliklerinizi uzak repoya göndermek için yukarıdaki diziyi yazın , yani Github'daki çatalınız (tim-peterson / dwolla-php)

• Bölüm 2 : Çekme Talebi Yapın: https://help.github.com/articles/using-pull-requests

  6. Github'daki çatalınızın web sayfasına gidin ( https://github.com/tim-peterson/dwolla-php )
  7. 'çekme isteği' düğmesini tıklayın
  8. çekme isteğine bir ad verin, yaptığınız değişikliklerin ayrıntılarını doldurun, gönder düğmesini tıklayın.
  9. sen bittin!!

Çekme isteği yapmak için aşağıdaki adımları uygulamanız gerekir:

1. Bir depoyu çatallayın (çekme isteği yapmak istediğiniz). Depo sayfasındaki çatal düğmesini tıkladığınızda, github kullanıcı adınızın önünde ayrı bir github deposu olacaktır.
2. Havuzu yerel makinenize kopyalayın. Yerel makinenize yüklediğiniz Github yazılımı bunu sizin için yapabilir. Depo adının yanındaki klon düğmesini tıklayın.
3. Dosyalarda yerel değişiklikler / taahhütler yapın
4. değişiklikleri senkronize et
5. github çatallı deponuza gidin ve şube düğmesinin yanındaki "Karşılaştır ve İncele" yeşil düğmesini tıklayın. (Düğmede simge var - metin yok)
6. Değişikliklerinizi gösteren yeni bir sayfa açılacak ve ardından isteği, çatalla doldurduğunuz deponun orijinal sahibine gönderecek olan çekme isteği bağlantısını tıklayın.

Bunu anlamam biraz zaman aldı, umarım bu birisine yardım eder.

İ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
• Klon repo düğmesine tıklayarak klon url'sini alın
• Terminale git ve çalıştır git clone <clone url you copied earlier>
• Yaptığınız değişiklikler için bir şube oluşturun git checkout -b branch-name
• Gerekli değişiklikleri yapın
• Değişikliklerinizi yapın git commit
• 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

Bir github.com hesabı olan, ancak komut satırına "git" yazdığımızda kötü bir hata mesajı alanlarımız için, tüm bunları tarayıcınızda nasıl yapacağınız aşağıda açıklanmıştır :)

1. Tim ve Farhan'in yazdığı gibi: Projenin kendi kopyasını topla:
2. Birkaç saniye sonra projenin kendi çatallı kopyasına yönlendirileceksiniz:
3. Değiştirmeniz gereken dosyalara gidin ve araç çubuğundaki "Bu dosyayı düzenle" yi tıklayın:
4. Düzenledikten sonra değişiklikleri açıklayan birkaç kelimeyi yazın ve ardından ana dalda olduğu gibi "Değişiklikleri uygula" yı yazın (çünkü bu yalnızca kendi kopyanızdır ve "ana" proje değildir).
5. Düzenlemeniz gereken tüm dosyalar için 3. ve 4. adımları tekrarlayın ve ardından proje kopyanızın kök dizinine dönün . Orada, yeşil "Karşılaştır, incele ..." düğmesini tıklayın:
6. Son olarak, isteğinizin başlığını ve açıklamasını tekrar kontrol ettikten sonra "Çekme isteği oluştur" .. 'u ve ardından "Çekme isteği oluştur" u tekrar tıklayın :

Tim Peterson'ın talimatlarını izledim ama değişikliklerim için yerel bir şube oluşturdum. Ancak, ittikten sonra GitHub'da yeni şubeyi görmedim. Çözüm push komutuna -u eklemekti:

git push -u origin <branch>

Sizin için bir PR şubesi kurma işini yapan bir bash programı yazdım. Gerekirse çatallama, yukarı akışla senkronizasyon, yukarı akış uzaktan kumandayı kurma vb. Gerçekleştirir ve sadece değişikliklerinizi yapmanız, bir PR göndermeniz ve göndermeniz yeterlidir.

Nasıl çalıştırdığınız aşağıda açıklanmıştır:

github-make-pr-branch ssh your-github-username orig_repo_user orig_repo_name new-feature

Programı burada bulacaksınız ve deposu aynı zamanda nasıl çalıştığını anlamak istiyorsanız aynı işlemi manuel olarak gerçekleştirmek için adım adım bir kılavuz ve ayrıca özellik dalınızı nasıl güncel tutacağınız hakkında daha fazla bilgi içerir. yukarı akış ustası ve diğer yararlı çerezlerle tarih.

En basit GitHub Çekme Talebi olan web arayüzünden budala kullanmadan.

1. Bir GitHub hesabı kaydedin, giriş yapın ve ardından depodaki değiştirmek istediğiniz sayfaya gidin.

2. Kurşun kalem simgesini tıklayın ,

   

   konumun yakınındaki metni arayın, istediğiniz düzenlemeleri yapın ve onaylamak için önizleyin. Önerilen değişikliğe 50 karaktere kadar bir açıklama ve isteğe bağlı olarak genişletilmiş bir açıklama verin ve ardından Dosya Değiştirmeyi Öner düğmesini tıklayın.

3. Bunu okuyorsanız, depoya (proje klasörleri) yazma erişiminiz olmaz, böylece GitHub hesabınızdaki havuzun (aslında bir dal) bir kopyasını oluşturur. Click çekme oluşturma isteği düğmesini.

4. Çekme İsteği'ne bir açıklama verin ve yorum ekleyin, ardından Çekme isteği oluştur düğmesini tıklayın.