Aracılığıyla paylaş

PowerShell belgelerine katkıda bulunma

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

Katkıda Bulunan Kılavuzu, Microsoft'ta belge oluşturmak için kullandığımız araçları ve işlemleri açıklayan bir makale koleksiyonudur. Bu kılavuzlardan bazıları, ' learn.microsoft.comde yayımlanan tüm belge kümelerinde ortak olan bilgileri kapsar. Diğer kılavuzlar, PowerShell belgelerini nasıl yazdığımıza özeldir.

Ortak makalelere merkezi Katkıda Bulunan Kılavuzumuzdan ulaşabilirsiniz. PowerShell'e özgü kılavuzlara buradan ulaşabilirsiniz.

Katkıda bulunma 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ı çözmek zordur ve daha fazla araştırma ve araştırma gerektirebilir. Sorun süreci, sorun hakkında konuşma yapmamı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 kapsamlı bir işlemdir. Aşağıdaki bilgilerde belgelere içerik göndermeye yönelik araçlar, süreçler ve standartlar özetlenmiştir.

Katkıda bulunmaya hazırlanma

Belgelere katkıda bulunmak için bir GitHub hesabı gerekir. Katkıda bulunmak için ihtiyacınız olan araçları yüklemek ve yapılandırmak için aşağıdaki denetim listesini kullanın.

  1. GitHub'a kaydolma
  2. Git ve Markdown araçlarını yükleme
  3. Docs Yazma Paketi'ni yükleme
  4. Posh-Git'i yükleme - gerekli değildir ancak önerilir
  5. Yerel Git deposu ayarlama
  6. Git ve GitHub ile ilgili temel bilgileri gözden geçirin

Belge yazmaya başlama

Belgelerde değişikliklere katkıda bulunmanın iki yolu vardır:

  1. Mevcut belgelerde hızlı düzenlemeler - Küçük düzeltmeler, yazım hatalarını düzeltme veya küçük eklemeler
  2. Belgeler için tam GitHub iş akışı : büyük değişiklikler, birden çok sürüm, görüntü ekleme veya değiştirme ya da yeni makalelere katkıda bulunma

Ayrıca, Merkezi Katkıda Bulunan Kılavuzu'nun Yazım Temelleri bölümünü okuyun. Bir diğer mükemmel kaynak da Microsoft Yazma Stili Kılavuzu'dur.

Genel depolardaki belgelerde ve kod örneklerinde yapılan küçük düzeltmeler veya açıklamalarda learn.microsoft.com Kullanım Koşulları ele alınmıştır.

Önemli değişiklikler yaparken tam GitHub iş akışını kullanın. Microsoft çalışanı değilseniz, çekme isteği doğrulama sistemimiz çekme isteğine çevrimiçi Katkı Lisans Sözleşmesi'ni (CLA) imzalamanızı isteyen bir yorum ekler. Pull request'inizi gözden geçirebilmemiz veya kabul edebilmemiz için önce bu adımı tamamlamanız gerekir. CLA'yı imzalamak, depoda ilk PR'ınızı gönderdiğinizde gereklidir. Yeni bir depoya her katkıda bulunmanız için CLA'yi imzalamanız istenebilir.

Kullanım kuralları

Microsoft Learn'de yayımlayan tüm depolar , Microsoft Açık Kaynak Kullanım Kuralları'na veya .NET Foundation Davranış Kuralları'na bağlıdır. Daha fazla bilgi için bkz. Kullanım Kuralları SSS.

Sonraki adımlar

Aşağıdaki makaleler PowerShell belgelerine özgü bilgileri kapsar. Merkezi Katkıda Bulunan Kılavuzu'ndaki yönergelerle örtüşme olduğunda, bu kuralların PowerShell içeriği için nasıl farklılık gösterdiğini belirtiriz.

Aşağıdaki belgeleri gözden geçirin:

Ek kaynaklar

  • Last updated on