Çekme İstekleri Nasıl Gönderilir

İçerikte değişiklik yapmak için fork'unuzdan bir çekme isteği (PR) gönderin. Bir çekme isteğinin birleştirilmeye başlanabilmesi için gözden geçirilmesi gerekir. En iyi sonuçları elde etmek için çekme isteğinizi göndermeden önce editoryal denetim listesini gözden geçirin.

Git dallarını kullanma

PowerShell-Docs için varsayılan dal main dalıdır. Çalışma dallarında yapılan değişiklikler, ardından yayımlanmadan önce main dalına birleştirilir. main dalı, hafta içi her gün saat 15:00'te (Pasifik Saati ile) live dalıyla birleştirilir. dal, live ' learn.microsoft.comde yayımlanan içeriği içerir.

Değişiklikleri başlatmadan önce, PowerShell-Docs deponuzun yerel kopyasında bir çalışma dalı oluşturun. Yerel olarak çalışırken, çalışma dalınızı oluşturmadan önce yerel deponuzu eşitlemeyi unutmayın. Çalışma dalı, main dalının up-totarihli bir kopyasından oluşturulmalıdır.

Tüm çekme talepleri, main dalını hedeflemelidir. Dalda live değişiklik göndermeyin. main dalında yapılan değişiklikler live dalıyla birleştirilir ve live dalında yapılan değişikliklerin yerini alır.

Pull request sürecinin herkes için daha iyi işlemesini sağlama

Pr'nizi ne kadar basit ve daha odaklanmış hale getirirseniz, o kadar hızlı gözden geçirilebilir ve birleştirilebilir.

Çok sayıda dosyayı güncelleştiren veya ilgisiz değişiklikler içeren çekme isteklerinden kaçının

İlişkisiz değişiklikler içeren PR'ler oluşturmaktan kaçının. Mevcut makalelere yönelik küçük güncelleştirmeleri yeni makalelerden veya ana yeniden yazmalardan ayırın. Bu değişiklikler üzerinde ayrı çalışma dallarında çalışın.

Toplu değişiklikler, çok sayıda değiştirilmiş dosya içeren PR'ler oluşturur. PR'lerinizi en fazla 50 değiştirilmiş dosyayla sınırlayın. Büyük PR'leri gözden geçirmek zordur ve hata içermeye daha yatkındır.

Dosyaları yeniden adlandırma veya silme

Dosyaları yeniden adlandırdığınızda veya sildiğinizde, PR ile ilişkilendirilmiş bir sorun olmalıdır. Bu sorun, dosyaları yeniden adlandırma veya silme gereksinimini ele almalıdır.

İçerik eklemelerini veya değişiklikleri dosya yeniden adlandırma ve silme işlemleriyle karıştırmaktan kaçının. Yeniden adlandırdığınız veya sildiğiniz tüm dosyalar uygun yeniden yönlendirme dosyasına eklenmelidir. Mümkün olduğunda, tüm İçindekiler tablosu dosyaları dahil olmak üzere yeniden adlandırılan veya silinen içeriğe bağlanan tüm dosyaları güncelleştirin.

Depo yapılandırma dosyalarını düzenlemekten kaçının

Depo yapılandırma dosyalarını değiştirmekten kaçının. Markdown içerik dosyalarında ve içerik için gereken destekleyici görüntü dosyalarında mümkün olduğunca değişikliklerinizi sınırlayın.

Depo yapılandırma dosyalarında yapılan yanlış değişiklikler derlemeyi bozabilir, güvenlik açıklarına veya erişilebilirlik sorunlarına neden olabilir ya da kuruluş standartlarını ihlal edebilir. Depo yapılandırma dosyaları, şu desenlerden biriyle veya daha fazlası ile eşleşen tüm dosyalardır:

• *.yml
• .github/**
• .localization-config
• .openpublishing*
• LICENSE*
• reference/docfx.json
• reference/mapping/**
• tests/**
• ThirdPartyNotices
• tools/**

Emniyet ve güvenlik için bu dosyaları değiştirmeyin. Bu dosyalardan birinin değiştirilmesi gerektiğini düşünüyorsanız bir sorun oluşturun. Bakımcılar sorunu önceliklendirmeden sonra uygun değişiklikleri yapacaktır.

Çekme isteği şablonunu kullan

Çekme isteği (PR) oluşturduğunuzda, PR gövdesine sizin için otomatik olarak bir şablon eklenir. Şuna benzer:

# PR Summary

<!--
    Delete this comment block and summarize your changes and list
    related issues here. For example:

    This changes fixes problem X in the documentation for Y.

    - Fixes #1234
    - Resolves #1235
-->

## PR Checklist

<!--
    These items are mandatory. For your PR to be reviewed and merged,
    ensure you have followed these steps. As you complete the steps,
    check each box by replacing the space between the brackets with an
    x or by clicking on the box in the UI after your PR is submitted.
-->

- [ ] **Descriptive Title:** This PR's title is a synopsis of the changes it proposes.
- [ ] **Summary:** This PR's summary describes the scope and intent of the change.
- [ ] **Contributor's Guide:** I have read the [contributors guide][contrib].
- [ ] **Style:** This PR adheres to the [style guide][style].

<!--
    If your PR is a work in progress, please mark it as a draft or
    prefix it with "(WIP)" or "WIP:"

    This helps us understand whether or not your PR is ready to review.
-->

[contrib]: /powershell/scripting/community/contributing/overview
[style]: /powershell/scripting/community/contributing/powershell-style-guide

"PR Özeti" bölümünde, değişikliklerinizin kısa bir özetini yazın ve ilgili sorunları, sorun numarasına göre #1234 ile listeleyin. Çekme isteğiniz sorunu düzeltirse veya çözerse, çekme isteğiniz birleştirildiğinde sorunun otomatik olarak kapatılması için GitHub'ın otomatik kapatma özelliğini kullanın.

"Pull İsteği Kontrol Listesi" bölümündeki öğeleri gözden geçirin ve her birini tamamladığınızda işaretleyin. Yönergeleri izlemeniz ve ekibin çekme talebinizi onaylaması için her öğeyi denetlemeniz gerekir.

Çekme isteğiniz devam eden bir çalışmaysa, bunu taslak moduna ayarlayın veya çekme isteği başlığınıza ön WIPek ekleyin.

Beklentiler Açıklaması

Çekme isteğinizi gönderdikten sonra, çekme isteğinize bir bot yorum yapacaktır. Açıklama kaynaklar sağlar ve sürecin geri kalanı için beklentileri ayarlar. Bu açıklamayı düzenli aralıklarla güncelleştirebiliriz, bu nedenle ilk katkınız olmasa bile açıklamayı her zaman gözden geçirin.

Docs PR doğrulama hizmeti

Docs PR doğrulama hizmeti, değişiklikleriniz üzerinde doğrulama kuralları çalıştıran bir GitHub uygulamasıdır. Doğrulama hizmeti tarafından bildirilen hataları veya uyarıları düzeltmeniz gerekir.

Aşağıdaki adımlarda doğrulama davranışı özetlenmiştir:

1. Bir çekme isteği gönderirsiniz.

2. Depoda etkinleştirilen "denetimlerin" durumunu gösteren GitHub açıklamasında. Bu örnekte iki denetim etkindir: "İşleme Doğrulaması" ve "OpenPublishing.Build":

   

   Komit doğrulaması başarısız olsa bile derleme geçebilir.

3. Daha fazla bilgi için Ayrıntılar'ı seçin. Ayrıntılar sayfası, başarısız olan tüm doğrulama denetimlerini gösterir ve sorunların nasıl düzeltileceğini gösteren bilgiler içerir.

4. Doğrulama başarılı olduğunda çekme isteğine aşağıdaki açıklama eklenir:

   

Uyarı

Dış katkıda bulunan (Microsoft çalışanı değil) iseniz ayrıntılı derleme raporlarına veya önizleme bağlantılarına erişiminiz yoktur.

PR gözden geçirildiğinde, değişiklik yapmanız veya doğrulama uyarı mesajlarını düzeltmeniz istenebilir. PowerShell-Docs ekibi doğrulama hatalarını ve editoryal gereksinimleri anlamanıza yardımcı olabilir.

GitHub İşlemleri

Yaptığınız değişiklikleri doğrulamak ve siz ile gözden geçirenlere bağlam sağlamak için çeşitli GitHub Actions çalıştırılır.

Denetim listesi doğrulama

Çekme isteğiniz taslak modunda değilse ve ön ek WIP'le belirtilmemişse, GitHub Action, çekme isteğinizin şablonundaki denetim listesindeki her öğeyi seçtiğinizi doğrulamak için inceleme yapar. Siz denetim listesini tamamlayana kadar bakımcılar çekme isteğinizi gözden geçirmez veya birleştirmez. Denetim listesi öğeleri zorunlu.

Yetkilendirme doğrulaması

Eğer çekme isteğiniz live dalını hedefliyorsa veya depo yapılandırma dosyalarını değiştiriyorsa, GitHub Action, bu değişiklikleri göndermeye yetkili olup olmadığınızı doğrulamak için izinlerinizi denetler.

Yalnızca depo yöneticileri dalını live hedefleme veya depo yapılandırma dosyalarını değiştirme yetkisine sahip.

Versiyonlu içerik değişikliği raporu

Çekme isteğiniz herhangi bir sürüme sahip içeriği ekler, kaldırır veya değiştirirse, GitHub Eylemi değişikliklerinizi analiz eder ve sürümlenmiş içerikte yapılan değişiklik türlerini özetleyen bir rapor yazar.

Bu rapor, bu çekme isteğinde güncelleştirmeniz gereken dosyaların başka sürümleri olup olmadığını gösterebilir.

Pull request'inizin sürüm içerik raporunu bulmak için:

1. Çekme isteği sayfanızda "Denetimler" sekmesini seçme.
2. İş listesinden "Raporlama" işini seçin.
3. Sağ üst köşedeki "..." düğmesini seçin.
4. "İş özetini görüntüle" seçeneğini belirleyin.

Sonraki adımlar

PowerShell-Docs stil kılavuzu

Ek kaynaklar

Çekme isteklerini yönetme şeklimiz