Bagikan melalui


Gambaran umum dokumentasi pengeditan di Microsoft Learn

Terima kasih atas minat Anda dalam mengedit dokumentasi di Microsoft Learn! Kontribusi Anda membantu kami memastikan dokumentasi kami ditulis dengan baik, terbaru, dan akurat. Informasi di halaman ini akan membantu Anda memutuskan metode kontribusi mana yang terbaik untuk Anda.

Prasyarat

Sebelum memulai, pastikan Anda masuk ke akun GitHub Anda. Jika Anda tidak memiliki akun GitHub, navigasikan ke https://github.com/join untuk proses pendaftaran yang cepat dan gratis.

Perubahan kecil pada dokumentasi

Perubahan kecil cepat dan mudah. Contoh perubahan kecil meliputi:

  • Memperbaiki kesalahan ketik
  • Merevisi satu artikel
  • Menambahkan bagian ke artikel
  • Mengoreksi kesalahan
  • Memperbarui tautan yang rusak

Jika Anda membuat perubahan kecil, yang Anda butuhkan hanyalah akun GitHub!

Untuk membuat perubahan kecil, pilih ikon Edit Pensil Dokumen Ini di bagian atas artikel. Tindakan ini membawa Anda ke file sumber di GitHub, tempat Anda dapat membuat perubahan. Setelah selesai, Anda akan diminta untuk membuat permintaan pull (PR) untuk mengusulkan perubahan Anda. Untuk panduan lengkap proses ini, lihat Mengedit dokumentasi di browser.

Perubahan besar pada dokumentasi

Perubahan besar melibatkan lebih banyak waktu dan upaya. Contoh perubahan besar meliputi:

  • Perubahan kompleks yang akan membawa Anda beberapa hari untuk menyelesaikan
  • Revisi ke beberapa artikel yang ingin Anda kirim bersama-sama
  • Membuat artikel baru
  • Sering berkontribusi

Jika Anda membuat perubahan besar, Anda perlu mengunduh dan menginstal beberapa alat untuk mempermudah pekerjaan Anda. Ikuti langkah-langkah berikut untuk memulai:

  1. Instal alat Git dan Markdown.
  2. Siapkan repositori Git lokal.
  3. Buat perubahan pada dokumentasi.
  4. Buat PR.

Ringkasan proses

Alur proses di bawah ini menunjukkan langkah-langkah tingkat tinggi yang terlibat dalam memulai perubahan kecil dan besar. Perhatikan bahwa beberapa item adalah langkah satu kali, sementara yang lain terjadi setiap kali Anda memulai kontribusi baru.

Peta alur proses memperlihatkan alur kerja dasar untuk memulai proses kontribusi.

Gambar dimulai dengan titik keputusan Apakah ini pertama kalinya Anda berkontribusi? Jika ya, langkah selanjutnya adalah menyiapkan akun GitHub Anda. Jika tidak, langkah berikutnya adalah poin keputusan lain dari Apakah perubahan Anda di bawah umur? Jika ya, langkah selanjutnya adalah mengedit di dalam browser. Jika tidak, langkah berikutnya melibatkan penginstalan alat penulisan, forking dan kloning repositori, membuat perubahan, membuka permintaan pull, dan meninjau dan menandatangani permintaan pull Anda.

Perubahan pada modul pelatihan

Kontributor tidak dapat mengedit atau mengusulkan perubahan pada modul pelatihan. Saat ini, hanya dokumentasi Microsoft Learn yang disimpan di repositori publik yang terbuka untuk kontribusi publik.