Meninjau dokumentasi menggunakan Masalah GitHub

Selesai

Salah satu cara paling berguna untuk berkontribusi pada Microsoft Learn adalah dengan memberikan umpan balik langsung pada artikel dokumentasi. Dengan menggunakan tautan umpan balik di halaman, Anda dapat memberikan pengeditan, saran, pertanyaan, atau wawasan lainnya saat muncul di penjelajahan Anda. Karena sebagian besar konten dokumentasi Microsoft Learn disimpan di repositori GitHub, Anda dapat memberikan umpan balik menggunakan proses GitHub yang disebut mengirimkan Masalah GitHub.

Masalah di GitHub adalah alat yang memungkinkan pengguna teknologi, insinyur, dan pengunjung Microsoft Learn lainnya untuk berbagi dan melacak umpan balik pada artikel tertentu. Anda mengisi formulir untuk mendokumen umpan balik Anda dan mempostingnya ke repositori artikel sumber di GitHub, di mana penulis atau pemilik akan diberi tahu. Siapa pun yang mengunjungi repositori GitHub dapat melihat Masalah. Mereka berfungsi sebagai cara yang berguna untuk mengumpulkan dan menyimpan umpan balik berharga, seperti melaporkan bug, permintaan fitur, atau catatan.

Mengapa meninjau konten di GitHub?

Memberikan ulasan konten di GitHub adalah cara langsung untuk berkontribusi pada topik yang Anda sukai atau berpengetahuan luas. Ini berarti Anda dapat menambahkan ide saat menjelajahi topik tentang dokumentasi Microsoft. Berkontribusi wawasan Anda ke kumpulan pengetahuan membantu meningkatkan pengalaman produk Microsoft untuk jutaan pengguna lain. Umpan balik Anda memajukan konten untuk pengunjung Microsoft Learn lainnya yang mengandalkan produk Microsoft dan konten pendukungnya.

Dalam kebanyakan kasus, mengirimkan umpan balik GitHub memungkinkan Anda mengirim ide Anda ke tim yang bertanggung jawab atas kumpulan konten produk. Jalur kolaborasi antara tim konten dan pengguna produk ini memungkinkan umpan balik untuk dibagikan dan dibahas langsung di GitHub.

Berkontribusi pada konten dokumentasi juga dapat memberikan manfaat profesional bagi Anda. GitHub adalah platform terkenal di mana kontribusi teknis dapat dibuat dan dilacak. Setiap kali Anda berkontribusi pada proyek di GitHub, itu tercermin di profil GitHub Anda. Seiring waktu, Anda dapat membangun catatan kontribusi Anda untuk ditambahkan ke portofolio teknis Anda.

Cara memberikan umpan balik tentang konten

Ingat bahwa banyak artikel dokumentasi di Microsoft Learn disimpan di repositori GitHub. Banyak repositori GitHub mengaktifkan masalah GitHub. Saat diaktifkan, Anda dapat menemukan opsi untuk mengirimkan umpan balik untuk halaman ini di bagian bawah artikel di learn.microsoft.com.

Cuplikan layar opsi umpan balik di bagian bawah artikel dokumentasi.

Berikut cara mengirimkan masalah di GitHub dari artikel Microsoft Learn:

  1. Navigasi ke artikel dokumentasi Microsoft Learn tempat Anda ingin memberikan umpan balik.

  2. Di bagian bawah artikel, temukan judul berlabel Umpan Balik. Di samping pertanyaan Apakah halaman ini bermanfaat?, ada tombol untuk Ya dan Tidak. Pilih tombol untuk menunjukkan apakah artikel tersebut berguna. Ini membuka formulir tempat Anda dapat mengisi komentar Anda.

  3. Pilih alasan umpan balik Anda.

  4. Dalam kotak teks berikut, jelaskan umpan balik Anda dan berikan konteks yang diperlukan.

  5. Setelah selesai, pilih Kirim.

Cuplikan layar formulir masalah GitHub kosong untuk mengirimkan umpan balik pada artikel dokumentasi.

Penulis artikel atau pemilik konten lainnya akan diberi tahu saat Anda mengirimkan Masalah Anda.