Pull request'ler

Bu özelliği neden kullanmalısınız?

• Zamandan tasarruf edin: Değişikliklerinize göre otomatik olarak ayrıntılı PR açıklamaları oluşturun.
• Tutarlılığı koruyun: Tüm PR'lerin tutarlı bir format izlemesini sağlayın.
• İşbirliğini geliştirin: İyi yapılandırılmış açıklamalarla inceleyiciler için net bağlam sağlayın.
• İş akışını kolaylaştırın: IDE'nizden çıkmadan PR'ler oluşturun.

Nasıl çalışır?

Bob, çalışmanızın amacını ve kapsamını anlamak için dal değişikliklerinizi, commit geçmişinizi ve dal adınızı analiz eder. Ardından, değişikliklerinizi özetleyen anlamlı bir PR başlığı ve ayrıntılı açıklama oluşturur, bu da inceleyicilerin PR'nizin bağlamını ve amacını anlamasını kolaylaştırır. Oluşturma işleminden sonra, göndermeden önce PR açıklamasını inceleyebilir ve düzenleyebilirsiniz.

PR oluşturma süreci etkileşimlidir ve PR'yi oluşturmadan önce hedef dalı ve uzak depoyu seçmenize olanak tanır.

Başlarken

Ön koşullar

• Değişiklikleriniz bir dala commit edilmiş olmalıdır.
• Uzak depoya push erişiminiz olmalıdır.

Temel kullanım

PR akışını başlatmak için 3 seçenekten birini seçebilirsiniz:

• Kaynak Kontrol panelindeki PR simgesine tıklayın.
• Komut paletini kullanın (Mac'te Cmd + Shift + P, Windows/Linux'ta Ctrl + Shift + P) ve "Bob: Generate PR" araması yapın.
• Bob sohbet arayüzünde /create-pr yazın.

Bob daha sonra sizi aşağıdaki adımlardan geçirecektir:

1. Birleştirmek istediğiniz temel dalı seçin. Bob en olası üç dalı önerecektir.
2. Birden fazla uzak deponuz varsa, uzak depoyu seçin.
3. Oluşturulan PR açıklamasını ve başlığını inceleyin.
4. PR'yi oluşturun.
5. Sohbetinizde yeni oluşturulan PR bağlantısını alın.

PR açıklamaları için şablonlar kullanma

Bob, pull request açıklamaları oluştururken projenizin mevcut PR şablonlarını otomatik olarak algılar ve kullanır. Bu, PR'lerinizin ekibinizin belirlediği standartlarla tutarlı olmasını sağlar. Bob projenizde birden fazla PR şablonu algıladığında, pull request'inize hangi şablonu uygulayacağınızı seçebilirsiniz.

Şablon algılama

Bob, proje kök dizininize göre aşağıdaki konumlarda PR şablonlarını arar:

1. ${cwd}/pull_request_template.md
2. ${cwd}/docs/pull_request_template.md
3. ${cwd}/.github/pull_request_template.md
4. ${cwd}/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md
5. ${cwd}/PULL_REQUEST_TEMPLATE/pull_request_template.md
6. ${cwd}/docs/PULL_REQUEST_TEMPLATE/pull_request_template.md

Bob birden fazla şablon bulursa, PR açıklaması için hangi şablonu kullanacağınızı seçmenizi isteyecektir.

Varsayılan şablon

Projenizde şablon bulunamazsa, Bob aşağıdakileri içeren yerleşik bir şablon kullanır:

• Dal adınızdan türetilen açıklayıcı bir başlık
• Değişikliklerin özeti
• Önemli uygulama detayları
• Test bilgileri
• İlgili bağlantılar veya referanslar

Oluşturulan açıklamayı düzenleme

PR açıklamasını oluşturduktan sonra Bob bunu doğrudan sohbette sunar. Ardından şunları yapabilirsin:

• Onayla ve devam et: PR oluşturmaya devam etmek için açıklamayı olduğu gibi onayla.
• Değişiklik iste: Sohbete geri bildirimini yaz; Bob, girişine göre açıklamayı yeniden oluşturur. Onaylamadan önce istediğin kadar yineleyebilirsin.

Şablonları özelleştirme

Bob'un PR oluşturma özelliğinden en iyi sonuçları almak için:

• Şablonlarınızda net bölüm başlıkları kullanın (örn. ## Summary, ## Changes)
• Bağlam sağlayan yer tutucu metin ekleyin (örn. <!-- Describe the purpose of this PR -->)
• Test talimatları ve ilgili sorunlar için bölümler eklemeyi düşünün

İpuçları ve en iyi uygulamalar

• Bob'un daha doğru PR açıklamaları oluşturmasına yardımcı olmak için açıklayıcı dal adları kullanın.
• PR'yi oluşturmadan önce oluşturulan açıklamayı inceleyin ve düzenleyin.