Membuat masalah GitHub untuk produk sumber terbuka
Artikel ini mengajarkan Anda cara membuat masalah GitHub untuk dokumentasi Microsoft Learn yang terkait dengan produk sumber terbuka. Ini juga mengajarkan Anda cara mempersingkat masalah pengguna lain dan menambahkan komentar Anda sendiri kepada mereka atau membuka permintaan pull (PR) untuk mengatasinya.
Dokumentasi produk sumber terbuka kami adalah pekerjaan berkelanjutan yang sedang berlangsung. Menerima masalah GitHub yang baik dari kontributor membantu kami memfokuskan upaya kami pada prioritas tertinggi bagi masyarakat.
Tentu saja, jika Anda tahu cara memperbaiki masalah, kami mengundang Anda untuk membuat perubahan sendiri, alih-alih membuka masalah.
Catatan
Hanya produk sumber terbuka yang menggunakan pengalaman umpan balik sumber terbuka yang menerima masalah GitHub. Untuk informasi selengkapnya dan daftar repositori yang berpartisipasi, lihat Menggunakan pengalaman sumber terbuka. Untuk mempelajari tentang cara memberikan umpan balik non-GitHub di seluruh platform Microsoft Learn, lihat Memberikan umpan balik tentang Microsoft Learn.
Prasyarat
- Buat akun GitHub, jika Anda tidak memilikinya.
Buat masalah
Navigasi ke artikel yang ingin Anda komentari.
Gulir ke bagian bawah artikel, tempat Anda akan melihat opsi untuk mengirimkan umpan balik. Pilih Buka masalah dokumentasi untuk membuat masalah baru. Umpan balik ini khusus untuk konten dan dilacak sebagai masalah di GitHub.
Secara opsional, pilih Berikan umpan balik produk untuk masuk ke tujuan (misalnya, portal umpan balik, GitHub, alamat email) tempat Anda dapat memberikan umpan balik tentang produk itu sendiri. Umpan balik ini independen dari konten dan tidak memiliki hubungan kembali ke artikel asli.
Sistem membuka masalah baru untuk Anda di repositori GitHub yang menyimpan konten untuk artikel yang Anda lihat. Menambahkan judul dan deskripsi; semua bidang lain harus diisi untuk Anda secara otomatis. Setelah selesai, pilih Kirim masalah baru.
Semakin detail yang Anda berikan, semakin membantu masalahnya. Beri tahu kami informasi apa yang Anda cari atau istilah pencarian yang Anda gunakan untuk masuk ke artikel ini. Jika Anda tidak dapat memulai, beri tahu kami bagaimana Anda ingin mulai menjelajahi teknologi yang tidak dikenal. Anda juga dapat menambahkan cuplikan layar atau file untuk membantu kami memahami masalah Anda.
Itu saja! Masalah Anda sekarang ditambahkan ke antrean Masalah. Masalah memulai percakapan tentang apa yang diperlukan. Tim konten akan menanggapi masalah ini dengan ide-ide untuk apa yang dapat kami tambahkan dan meminta pendapat Anda.
Mengomentari masalah
Anda dapat mengomentari masalah apa pun di repositori yang mendukung masalah GitHub. Anda juga dapat menambahkan komentar Anda sendiri ke masalah yang telah Anda buat.
Temukan masalah yang ingin Anda komentari. Di browser Anda, navigasikan ke repositori GitHub yang ingin Anda lihat masalahnya. Pilih tab Masalah untuk melihat masalah terbuka untuk repositori tersebut. Jika repositori memiliki banyak masalah, gunakan bilah Filter untuk memfilter menurut label, penulis, dan lainnya. Atau gunakan bilah Pencarian untuk mencari kueri tertentu. Setelah Anda menemukan masalah yang menarik bagi Anda, pilih masalah tersebut untuk membukanya.
Hanya produk sumber terbuka yang menggunakan pengalaman umpan balik sumber terbuka yang menerima masalah GitHub. Untuk informasi selengkapnya dan daftar repositori yang berpartisipasi, lihat Menggunakan pengalaman sumber terbuka.
Baca masalah dan komentar apa pun yang telah ditambahkan oleh orang lain. Jika Anda ingin menambahkan komentar, gulir ke bagian bawah masalah dan masukkan komentar Anda di kotak Tinggalkan komentar . Setelah selesai, pilih Komentar.
Buka permintaan pull untuk mengatasi masalah
Saat menelusuri masalah, Anda mungkin menemukan masalah yang anda tahu cara memperbaikinya. Jika demikian, Anda dipersilakan untuk membuka PR untuk mengatasi masalah tersebut. Untuk informasi selengkapnya, lihat Mengedit dokumentasi di browser.
Setelah Anda membuka PR untuk mengatasi masalah tersebut, kembali ke masalah dan tambahkan komentar yang ditautkan ke PR Anda. Ini membantu kami melacak masalah dan PR bersama-sama. Gunakan tanda pagar (#) diikuti dengan nomor PR untuk menautkan ke PR. Misalnya, jika nomor PR Anda adalah 4210, Anda akan memasukkan #4210 komentar Anda.
