PowerShell belgelerine katkıda bulunma

PowerShell'e desteğiniz için teşekkür ederiz!

Katılımcı Kılavuzu, Microsoft'ta belge oluşturmak için kullandığımız araçları ve süreçleri açıklayan bir makale koleksiyonudur. Bu kılavuzlardan bazıları, learn.microsoft.com'da yayınlanan tüm belge setlerinde ortak olan bilgileri kapsar. Diğer kılavuzlar PowerShell için belgeleri nasıl yazdığımıza özeldir.

Ortak makaleler merkezi Katılımcı Kılavuzumuzda mevcuttur. PowerShell'e özel kılavuzlara buradan ulaşabilirsiniz.

Katkıda bulunmanın yolları

Katkıda bulunmanın iki yolu vardır. Her iki katkı da bizim için değerlidir.

Dosyalama sorunları, belgelerimizdeki sorunları ve boşlukları belirlememize yardımcı olur. Bazen sorunların çözülmesi zordur ve daha fazla araştırma ve araştırma gerektirir. Sorun süreci, sorun hakkında konuşmamıza ve tatmin edici bir çözüm geliştirmemize olanak tanır.
İçerik eklemek veya değiştirmek için çekme isteği göndermek daha karmaşık bir süreçtir. Aşağıdaki bilgiler belgelere içerik göndermeye yönelik araçları, süreçleri ve standartları özetlemektedir.

Katkıda bulunmaya hazırlanın

Belgelere katkıda bulunmak GitHub hesabı gerektirir. Katkıda bulunmak için ihtiyaç duyduğunuz araçları yüklemek ve yapılandırmak için aşağıdaki kontrol listesini kullanın.

GitHub'a kaydolun
Git ve Markdown araçlarını yükleyin
Doküman Yazma Paketi'ni yükleyin
Posh-Git'i yükleyin - zorunlu değil ancak önerilir
Yerel bir Git deposu kurun
Git ve GitHub temellerini inceleyin

Doküman yazmaya başlayın

Dokümantasyona değişiklik eklemenin iki yolu vardır:

Mevcut dokümanlarda hızlı düzenlemeler - Küçük düzeltmeler, yazım hatalarını düzeltme veya küçük eklemeler
Dokümanlar için tam GitHub iş akışı - büyük değişiklikler, birden fazla sürüm, resim ekleme veya değiştirme veya yeni makalelere katkıda bulunma

Ayrıca, merkezi Katılımcı Kılavuzu'nun Yazmayla ilgili temel bilgiler bölümünü okuyun. Bir başka mükemmel kaynak da Microsoft Yazma Stili Kılavuzu'dur.

Genel veri havuzlarındaki belgelerde ve kod örneklerinde yapılan küçük düzeltmeler veya açıklamalar, Learn.microsoft.com Kullanım Koşulları kapsamındadır.

Önemli değişiklikler yaparken GitHub iş akışının tamamını kullanın. Microsoft çalışanı değilseniz PR doğrulama sistemimiz, çekme isteğine çevrimiçi Katkı Lisans Sözleşmesini (CLA) imzalamanızı isteyen bir yorum ekler. Çekme isteğinizi inceleyebilmemiz veya kabul edebilmemiz için bu adımı tamamlamanız gerekir. CLA'yı imzalamanız yalnızca depoya ilk PR gönderdiğinizde gereklidir. Yeni bir havuza her katkıda bulunduğunuzda CLA'yı imzalamanız istenecektir.

Davranış kodu

Microsoft Learn'de yayın yapan tüm depolar, Microsoft Açık Kaynak Davranış Kurallarını veya .NET Foundation Davranış Kurallarını benimsemiştir. Daha fazla bilgi için Davranış Kuralları SSS bölümüne bakın.

Sonraki adımlar

Aşağıdaki makaleler PowerShell belgelerine özel bilgileri kapsamaktadır. Merkezi Katkıda Bulunan Kılavuzu'ndaki rehberlikle örtüşen durumlarda, bu kuralların PowerShell içeriği için ne kadar farklı olduğunu belirtiyoruz.

Aşağıdaki belgeleri inceleyin:

Doküman yazmaya başlayın
Markdown'ın en iyi uygulamaları
PowerShell-Docs stil kılavuzu
Bir sorun nasıl bildirilir
Çekme isteği gönderme

Ek kaynaklar