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:
- Git ve Markdown araçlarını yükleyin.
- Yerel bir Git deposu ayarlayın.
- Belgelerde değişiklik yapın.
- Ç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.
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.