Cara melaporkan bug
Tujuan dokumen ini adalah untuk memberikan petunjuk langkah demi langkah tentang cara melaporkan bug di Fedora. Untuk informasi lebih lanjut tentang penggunaan Bugzilla, lihat bagian Bug pada Quick Docs.
Sebuah bug perangkat lunak tidak selalu harus menyebabkan crash. Setiap perilaku yang tidak diinginkan dalam perangkat lunak dapat dilaporkan sebagai bug. Pemelihara paket kemudian dapat memeriksa laporan bug dan memutuskan tindakan terbaik yang harus diambil.
| Siapa pun dapat melaporkan bug: Semua pengguna didorong untuk melaporkan bug apa pun yang mereka temui. Pelaporan bug tidak terbatas pada pengembang perangkat lunak saja. |
Istilah
Ada beberapa istilah yang sering digunakan dalam dokumen ini:
-
Bug: Bug adalah perilaku dalam perangkat lunak yang muncul secara tidak terduga/tidak diinginkan.
-
Bug tracker: Sistem pelacakan bug Fedora di https://bugzilla.redhat.com.
-
Paket: Setiap perangkat lunak yang tersedia di Fedora memiliki nama paket resmi yang digunakan oleh sistem pelacakan bug dan alat infrastruktur lainnya. Paket dapat dicari menggunakan Fedora dist-git.
-
Maintainer: Kelompok sukarelawan yang bertanggung jawab atas paket perangkat lunak yang disediakan di Fedora. Mereka disebut sebagai “pengelola paket”. Mereka memantau bug, membantu menyelesaikan masalah, dan umumnya bertindak sebagai perantara antara pengembang perangkat lunak dan pengguna Fedora.
-
QA: Jaminan kualitas adalah proses untuk memastikan bahwa perangkat lunak berfungsi sesuai dengan yang direncanakan.
Sebelum melaporkan bug
Ask Fedora — forum dukungan komunitas — adalah tempat yang baik untuk memulai jika Anda tidak yakin apakah Anda telah menemui bug. Terkadang, apa yang dianggap sebagai bug sebenarnya adalah kesalahpahaman atau pertanyaan. Komunitas Ask Fedora dapat membantu Anda menentukan apakah Anda telah menemui bug — dan apakah bug tersebut spesifik untuk Fedora atau terdapat di paket hulu.
Langkah 0: Periksa halaman Masalah Umum
Kami menyimpan daftar masalah umum. Periksa situs ini terlebih dahulu untuk melihat apakah masalah Anda telah dilaporkan — dan apakah ada solusinya.
Langkah 1: Periksa versi terbaru
Saat bug dilaporkan dan diperbaiki, pengembang mengumpulkan serangkaian perbaikan dan secara berkala merilis versi yang lebih baik dari perangkat lunak mereka. Oleh karena itu, sebelum melaporkan masalah, disarankan untuk memeriksa apakah Anda menggunakan versi terbaru dari perangkat lunak tersebut. Cara termudah untuk mendapatkan versi terbaru perangkat lunak di Fedora adalah dengan secara rutin memperbarui sistem Anda. Pengguna Gnome/KDE dan lingkungan desktop lainnya dapat menggunakan aplikasi bawaan mereka untuk melakukannya. Aplikasi ini secara berkala memeriksa pembaruan dan memberi tahu pengguna. Anda juga dapat menggunakan manajer paket default dnf untuk memeriksa dan memperbarui sistem Anda. Hanya pengguna dengan hak administrator yang dapat melakukannya:
$ sudo dnf upgrade --refresh
Langkah 2: Periksa bug yang sudah dilaporkan
Jika Anda menggunakan versi terbaru perangkat lunak yang tersedia di Fedora, kemungkinan besar bug tersebut belum dilaporkan, atau telah dilaporkan tetapi perbaikannya belum dirilis. Oleh karena itu, disarankan untuk mencari daftar bug yang sudah dilaporkan sebelum mengajukan laporan baru. Aplikasi web Fedora Packages menyediakan tautan ke bug yang terbuka untuk suatu paket. Ada juga pintasan yang nyaman yang dapat digunakan.
https://bugz.fedoraproject.org/<nama paket>
Di sini, package name harus merupakan nama resmi dari paket tersebut.
| Menemukan nama paket: Jika Anda tidak mengetahui nama paket resmi perangkat lunak, Anda dapat menggunakan aplikasi Web Fedora Packages untuk mencarinya dan melihat daftar bug di sana. |
| Pencarian lanjutan: Anda juga dapat menggunakan fitur pencarian lanjutan pelacak bug untuk mempersempit hasil pencarian Anda. Namun, hal ini tidak wajib. |
Jika laporan bug sudah diajukan yang menjelaskan masalah tersebut, Anda harus menyertakan informasi tambahan yang Anda miliki. Jika tidak ada informasi tambahan yang perlu ditambahkan ke laporan, Anda harus “CC” (carbon-copy) diri Anda ke laporan tersebut untuk menerima pembaruan. Hal ini dapat dilakukan dengan mengklik tombol “Simpan perubahan” saat opsi “Tambahkan saya ke daftar CC” sudah dicentang seperti yang ditunjukkan di bawah ini:
Mengajukan laporan bug
Langkah 0: Buat akun Bugzilla
Laporan bug diajukan di Bugzilla dan Anda harus memiliki Akun Bugzilla untuk mengajukan bug dan berinteraksi dengannya. Setelah Anda membuat akun di Bugzilla, Anda juga dapat masuk menggunakan Akun Fedora Anda. Untuk menggunakan akun FAS Anda untuk masuk ke Bugzilla, Anda perlu menggunakan alamat email yang sama di FAS dan Bugzilla, atau jika berbeda, Anda dapat mengatur alamat email Bugzilla secara eksplisit di profil FAS Anda.
Sistem pelacak bug hanya akan mengirimkan pemberitahuan email tentang bug yang melibatkan pengguna. Tidak akan ada email lain yang dikirimkan.
Langkah 1: Melaporkan bug baru
Jika laporan bug untuk masalah tertentu belum diajukan, Anda harus mengajukan laporan baru. Cara termudah untuk mengajukan laporan baru adalah dengan mencari paket di Aplikasi Web Paket Fedora, dan menggunakan tautan “Ajukan laporan bug baru” yang disediakan di halaman tersebut.
Ini akan mengarahkan Anda ke templat laporan bug baru di sistem pelacakan bug. Gambar di bawah ini menunjukkan templat laporan bug baru:
Berikut ini adalah bidang-bidang yang perlu diatur:
-
Komponen: Ini akan disetel ke nama paket.
-
Versi: Anda harus mengatur ini ke versi Fedora di mana Anda menemukan bug tersebut.
-
Ringkasan: Anda harus memberikan ringkasan singkat yang bermanfaat tentang masalah ini di sini.
-
Deskripsi: Informasi yang lebih rinci tentang masalah ini harus disertakan di sini. Templatnya sudah tersedia, yang dijelaskan di bawah ini.
-
Lampiran: Berkas yang memberikan informasi tambahan mengenai masalah dapat diunggah bersama laporan bug menggunakan tombol di sini. Contoh: tangkapan layar, berkas log, rekaman layar.
-
Severitas, Perangkat Keras, Sistem Operasi: Bidang-bidang ini bersifat opsional dan tidak perlu diisi.
Deskripsi masalah:
Jelaskan masalah ini secara lebih rinci di sini.
Nomor versi dan rilis komponen yang dipilih (jika berlaku):
Versi paket harus ditentukan di sini. Setelah nama paket diketahui, versi dapat diperoleh dengan menggunakan perintah rpm:
$ rpm -q <packagename>
Misalnya:
$ rpm -q gnome-software gnome-software-3.28.2-1.fc28.x86_64
Seberapa dapat diulang:
Seberapa sering masalah ini diamati? Biasanya, jawaban yang baik untuk bidang ini adalah salah satu dari:
-
Selalu: masalah ini diamati setiap kali.
-
Terkadang: masalah tersebut terjadi, tetapi tidak setiap kali.
-
Hanya sekali: masalah tersebut hanya diamati sekali.
Masalah yang terjadi secara konsisten paling mudah didiagnosis oleh pengembang, karena mereka juga dapat mereplikasi masalah tersebut di mesin mereka untuk mengumpulkan informasi tambahan. Jika masalah hanya terjadi sesekali, pengembang harus menghabiskan lebih banyak waktu dan usaha untuk memahami penyebab masalah tersebut. Jika masalah hanya diamati sekali, debugging menjadi lebih sulit.
| Laporan bug yang detail memudahkan perbaikan bug: Jika memungkinkan, sebaiknya Anda mencoba menyelidiki langkah-langkah apa yang menyebabkan masalah terjadi dan menyertakan langkah-langkah tersebut di bagian berikutnya: |
| Kirimkan laporan meskipun tidak yakin: Jika Anda tidak yakin apa yang harus diisi, Anda tetap harus mengirimkan laporan bug. Pengelola dapat menghubungi Anda untuk menanyakan informasi tambahan. |
Langkah-langkah untuk Mengulang:
Hal ini memungkinkan pengguna lain untuk memverifikasi bug tersebut, dan juga memberi tahu pengembang tentang langkah-langkah spesifik yang menyebabkan masalah. Hal ini memudahkan mereka untuk memeriksa kode sumber dan mengidentifikasi bagian-bagian yang mungkin bermasalah.
Hasil aktual:
Apa yang diamati ketika masalah terjadi?
Hasil yang diharapkan:
Apa yang diharapkan pengguna akan terjadi jika perangkat lunak berfungsi dengan benar?
Informasi tambahan:
Informasi tambahan yang mungkin berguna bagi pengelola harus ditambahkan di sini.
Langkah 2: Lakukan tindak lanjut terhadap laporan yang telah diajukan
Setelah sebuah bug dilaporkan, Anda sebaiknya memantau pembaruan apa pun. Dokumen bug status workflow menjelaskan berbagai status yang mungkin dimiliki oleh sebuah bug. Pemberitahuan email tentang komentar baru pada laporan akan dikirimkan kepada semua pihak yang terlibat dalam laporan bug—pelapor, pengguna lain, dan pemelihara. Seringkali, pemelihara akan memberikan komentar dengan pertanyaan untuk mengumpulkan informasi tambahan tentang masalah tersebut. Terkadang, pengguna lain yang mengalami masalah yang sama juga dapat menambahkan informasi tambahan.
| Minta petunjuk: Jika para pengelola meminta informasi tambahan tetapi tidak jelas bagaimana cara mengumpulkannya, tidak ada masalah untuk meminta petunjuk yang jelas dari para pengelola. |
| Pemberitahuan email: Pemberitahuan dikirim dari alamat bugzilla@redhat.com. Anda disarankan untuk memeriksa email dari alamat ini dan menambahkannya ke daftar “tidak spam” Anda. |
Langkah 3: Uji pembaruan
Sebuah bug yang dilaporkan dengan baik biasanya akan diperbaiki, dan pengembang akan menyediakan versi yang diperbarui dari perangkat lunak tersebut untuk pengguna Fedora. Bodhi akan menambahkan komentar pada laporan tersebut ketika hal ini terjadi. Anda dapat membantu pengembang dengan mengonfirmasi apakah versi yang diperbarui berfungsi lebih baik di Bodhi.
| Bantu uji pembaruan: Semua pengguna dapat membantu dengan menguji versi baru perangkat lunak. Informasi lebih lanjut tentang hal ini dapat ditemukan di sini. Perhatikan bahwa hal ini memerlukan akun Fedora di Fedora. |
Setelah versi yang diperbarui dari perangkat lunak telah lolos proses QA, bug tersebut akan secara otomatis ditutup. Selamat!
Saran untuk jenis bug tertentu
Crash (Mogok)
Jika Anda mengalami crash program, hampir pasti Anda perlu menyertakan stack trace dalam laporan bug Anda. Crash seringkali sulit untuk direproduksi dan bahkan lebih sulit untuk diperbaiki, jadi semakin banyak informasi yang Anda berikan, semakin baik. Anda mungkin perlu menginstal paket -debuginfo RPM agar stack trace Anda memiliki simbol debugging yang berguna. Lihat halaman-halaman berikut untuk informasi lebih lanjut:
Permohonan Peningkatan
| Sebagian besar permintaan peningkatan sebaiknya diajukan ke proyek hulu. Jika perangkat lunak tersebut tidak memiliki fitur yang menurut Anda seharusnya ada, Anda sebaiknya mengajukan permintaan tersebut ke sistem pelacakan bug proyek hulu. Permintaan fitur di Fedora Linux umumnya melibatkan perubahan pengaturan default, mengaktifkan fitur yang dinonaktifkan secara default, dan sebagainya. |
-
Saat mengajukan permintaan peningkatan di Bugzilla, tambahkan kata kunci
Future Featureke laporan. Kata kunci tersebut harus ditambahkan segera setelah melaporkan bug. Anda akan melihat kotak input kata kunci tersebut. Pastikan Anda menyediakan informasi dan alasan yang cukup untuk permintaan peningkatan Anda agar dipertimbangkan. -
Proyek Fedora bertujuan untuk menjadi platform yang dibangun secara eksklusif dari perangkat lunak bebas dan sumber terbuka. Usulan untuk menyertakan dukungan terhadap perangkat lunak proprietary atau perangkat lunak lain yang terikat secara hukum tidaklah konstruktif. Lihat daftar forbidden items untuk detail lebih lanjut mengenai hal ini.
-
Jika Anda ingin membuat fitur baru, buatlah halaman wiki untuk fitur tersebut dan dapatkan persetujuannya. Lihat lebih lanjut di Proses Perubahan.
-
Permohonan untuk menambahkan paket baru ke Fedora tidak boleh diajukan di Bugzilla.
Antarmuka Pengguna Grafis
Jika Anda mengalami masalah dengan antarmuka pengguna grafis (GUI), seringkali membantu untuk menyertakan tangkapan layar atau rekaman layar yang menunjukkan bug tersebut terjadi. Hal ini membantu pengembang menemukan lokasi tepat dalam kode yang menyebabkan bug, serta membantu menjelaskan apa yang salah ketika sulit untuk mereproduksi masalah (misalnya, masalah tata letak yang spesifik pada mesin tertentu).
Bug yang Spesifik pada Perangkat Keras
Tanda yang kuat bahwa suatu bug bersifat spesifik perangkat keras adalah bahwa orang lain dengan perangkat keras yang berbeda seharusnya dapat mereproduksi bug tersebut, tetapi tidak bisa. Bug-bug ini biasanya melibatkan kode yang secara khusus berinteraksi dengan periferal, seperti webcam, kartu grafis, printer, atau kartu suara (misalnya, bug yang memengaruhi antarmuka pengguna pengolah kata atau kalkulator desktop jarang bersifat spesifik perangkat keras).
Jika Anda menduga bahwa bug yang Anda temui terkait dengan perangkat keras tertentu yang Anda miliki, maka perlu untuk mengidentifikasi perangkat keras tersebut agar tindakan yang tepat dapat diambil.
Perangkat PCI dan PCI-E yang ditemukan oleh kernel dapat ditampilkan dengan perintah lspci.
Perangkat USB yang terdeteksi oleh kernel dapat ditampilkan dengan perintah lsusb.
Anda juga mungkin menemukan referensi tentang perangkat atau driver tertentu dalam log sistem Anda (jalankan journalctl).
Berkaitan dengan Keamanan
Kami memberikan perhatian khusus pada bug yang berkaitan dengan keamanan. Baca halaman Laporan Kerentanan Keamanan untuk memahami proses khusus dalam melaporkan bug keamanan.
Lebih banyak bacaan
Berikut ini adalah beberapa sumber daya tambahan bagi mereka yang ingin melaporkan bug dengan lebih baik dengan memberikan informasi yang lebih lengkap:
Want to help? Learn how to contribute to Fedora Docs ›