Microsoft Learn'de belgeleri düzenlemeye genel bakış

Microsoft Learn'deki belgeleri düzenlemeye ilginiz için teşekkür ederiz! Katkılarınız, belgelerimizin iyi yazılmasını, güncel ve doğru olmasını sağlamamıza yardımcı olur. Bu sayfadaki bilgiler, hangi katkı yönteminin sizin için en uygun olduğuna karar vermenize yardımcı olacaktır.

Önkoşul

Başlamadan önce GitHub hesabınızda oturum açtığınızdan emin olun. GitHub hesabınız yoksa hızlı ve ücretsiz kaydolma işlemi için adresine gidin https://github.com/join .

Belgelerde küçük değişiklikler

Küçük değişiklikler hızlı ve kolaydır. Küçük değişikliklere örnek olarak şunlar verilebilir:

  • Yazım hatalarını düzeltme
  • Tek bir makaleyi gözden geçirme
  • Makaleye bölüm ekleme
  • Hatayı düzeltme
  • Bozuk bağlantılar güncelleştiriliyor

Küçük değişiklikler yapıyorsanız tek ihtiyacınız olan bir GitHub hesabıdır!

Küçük bir değişiklik yapmak için makalenin üst kısmındaki Bu Belgeyi Düzenle kalem simgesini seçin. Bu eylem sizi GitHub'da kaynak dosyaya götürür ve burada değişikliklerinizi yapabilirsiniz. İşiniz bittiğinde, değişikliklerinizi önermek için bir çekme isteği (PR) oluşturmanız istenir. Bu işlemin tam kılavuzu için bkz . Tarayıcıda belgeleri düzenleme.

Belgelerde önemli değişiklikler

Büyük değişiklikler daha fazla zaman ve çaba gerektirir. Önemli değişikliklere örnek olarak şunlar verilebilir:

  • Tamamlanması birkaç gün sürecek karmaşık değişiklikler
  • Birlikte göndermek istediğiniz birden çok makalenin düzeltmeleri
  • Yeni makale oluşturma
  • Sık sık katkıda bulunma

Önemli değişiklikler yapıyorsanız, işinizi kolaylaştırmak için birkaç araç indirip yüklemeniz gerekir. Başlamak için şu adımları izleyin:

  1. Git ve Markdown araçlarını yükleyin.
  2. Yerel bir Git deposu ayarlayın.
  3. Belgelerde değişiklik yapın.
  4. Çekme isteği oluşturun.

İşlem genel bakışı

Aşağıdaki işlem akışında küçük ve büyük değişikliklere başlarken yer alan üst düzey adımlar gösterilmektedir. Bazı öğelerin tek seferlik adımlar olduğuna, bazıları ise her yeni katkı başlattığınızda gerçekleştiğine dikkat edin.

Katkı sürecine başlamak için temel iş akışını gösteren süreç akışı haritası.

Görüntü, ilk kez mi katkıda bulunuyorsunuz? Evet ise, sonraki adım GitHub hesabınızı ayarlamaktır. Hayır ise, bir sonraki adım değişikliğiniz küçük mü? Evet ise, sonraki adım tarayıcı içinde düzenlemektir. Hayır ise, sonraki adımlar yazma araçlarını yüklemeyi, depoyu çatallamayı ve kopyalamayı, değişiklik yapmayı, çekme isteğini açmayı ve çekme isteğinizi gözden geçirmeyi ve oturumu kapatmayı içerir.

Eğitim modüllerindeki değişiklikler

Katkıda bulunanlar eğitim modüllerini düzenleyemez veya değişiklik öneremez. Şu anda yalnızca genel depolarda depolanan Microsoft Learn belgeleri genel katkılar için açıktır.