How to report a bug/id

Panduan berikut menjelaskan cara menulis sebuah laporan kekutu atau permintaan fitur yang baik (task; tugas) di pelacak tugas Wikimedia (lihat untuk informasi selengkapnya). Tugas yang ditulis dengan baik lebih dipilih untuk dikerjakan.



Saran kilat

 * Tepat sasaran
 * Jelas: tuliskan cara membuat ulang kendala, langkah demi langkah, sehingga yang lain dapat meniru kekutu tersebut atau memahami permintaan Anda.
 * Sertakan satu kendala saja per tugas
 * Sertakan pranala maupun contoh apa pun yang relevan
 * Harus jelas: terangkan 1) cara membuat ulang situasinya, langkah demi langkah, tanpa meninggalkan kemungkinan salah tafsir, 2) hasil yang diharapkan, 3) hasil yang terjadi, dalam bagian-bagian yang terpisah.
 * Hanya sertakan satu kendala per tugas
 * Sertakan pranala dan contoh yang relevan



Sebelum memulai


Apakah Anda dapat membuat ulang masalah?
Cobalah untuk membuat ulang kekutu Anda menggunakan versi terkini dari perangkat lunak, untuk melihat apakah masalah tersebut telah diperbaiki. Jika kekutu tersebut ada pada situs wiki seperti Wikipedia, Anda dapat mencoba menguji versi perangkat lunak yang terkini di test2.wikipedia.org.



Apakah orang lain telah melaporkan masalah tersebut?
Gunakan kotak telusur pelacak kekutu Wikimedia untuk melihat apakah kekutu tersebut telah dilaporkan, atau fitur tersebut telah diminta. Anda juga dapat melakukan penelusuran lebih lanjut di halaman penelusuran lanjutan.

Jika Anda tidak yakin apakah suatu kekutu telah dilaporkan, Anda dapat melaporkannya. Memiliki laporan kekutu yang duplikat masih lebih baik dari pada jika tidak dilaporkan sama sekali.



Apakah itu mungkin merupakan masalah peralatan / skrip pengguna?
Beberapa kendala merupakan konsekuensi dari menggunakan peralatan dan skrip pengguna yang memerlukan sedikit perbaikan. Terdapat berisi langkah-langkah cara agar Anda dapat mengidentifikasi kode semacam ini, yang dapat memperbaiki masalah Anda sehingga Anda tidak perlu menghabiskan waktu Anda untuk melaporkannya.



Melaporkan kekutu atau permintaan fitur baru
Jika Anda menghadapi suatu kekutu pada versi terkini dan nampaknya belum ada seorang pun yang melaporkannya, maka:
 * 1) Buka phabricator.wikimedia.org.
 * 2) Anda akan diharuskan untuk masuk log (atau mendaftar) jika Anda belum melakukannya (lihat "").
 * 3) Klik Bookmark button di pojok kanan atas dan pilih "Create Task" (atau "Report Security issues" untuk ).
 * 4) Isilah setidaknya bidang-bidang berikut:
 * 5) * Title (Judul): Sebuah ringkasan satu-kalimat pendek yang menjelaskan kendala tersebut (bukan solusi yang Anda sarankan)
 * 6) ** Baik:
 * 7) ** Buruk:
 * 8) * Description (Deskripsi): Rincian lengkap dari masalah, berikan sebanyak mungkin informasi yang Anda punya. Jika itu belum cukup, Anda akan diminta memberikan informasi tambahan beserta petunjuk cara mendapatkannya. Bagian ini harus berisi:
 * 9) ** Untuk kekutu:
 * 10) *** Langkah untuk Membuat Ulang Kendala: Langkah-langkah padat dan jelas yang mudah diikuti yang akan memicu kendala yang dijelaskan. Sertakan langkah-langkah pengaturan khusus apa pun.
 * Contoh:
 * 1) *** Hasil Kenyataan: Apa yang diperbuat aplikasi setelah melaksanakan langkah-langkah di atas.
 * Contoh:
 * 1) *** Hasil Diharapkan: Apa yang seharusnya diperbuat aplikasi, jika tidak ada kekutu.
 * Contoh:
 * 1) ** Untuk permintaan fitur:
 * 2) *** Deskripsi tentang apa yang ingin Anda capai, dan alasannya. Jelaskan apa yang Anda harapkan akan diselesaikan oleh fitur tersebut (kendala di baliknya yang sesungguhnya) disertai dengan contoh spesifik; namun jangan mengharapkan sebuah solusi spesifik, karena mungkin ada solusi yang lain/lebih baik. Cerita pengguna merupakan sebuah cara yang efektif untuk menyampaikan hal ini.
 * Contoh:
 * 1) ** Harap sediakan juga informasi lainnya yang mungkin berguna, seperti:
 * 2) *** peramban web, kulit tema, atau sistem komputer di mana Anda menemukan kekutu ini;
 * 3) *** pranala atau riwayat versi ke satu atau lebih halaman di mana Anda menghadapi kekutu ini;
 * 4) *** apakah kendala ini muncul setiap kali, hanya sesekali, hanya pada halaman-halaman tertentu, atau hanya dalam situasi dan kondisi spesifik.
 * 5) * Untuk melampirkan sebuah berkas log atau (namun pastikan tidak ada data pribadi yang disertakan atau ditunjukkan), klik tombol Upload Files (Unggah Berkas) (awan dengan sebuah tanda panah) pada bilah alat di bidang Description.
 * 6) * Pilih Tags (satu atau lebih proyek) di mana Anda menemukan kekutu ini:
 * 7) ** Proyek merupakan cara pengembang menemukan tugas untuk dikerjakan. Untuk mengidentifikasi satu (atau lebih) proyek yang tepat, gunakan fungsi pencarian (di kanan atas) untuk menemukan deskripsinya.
 * 8) ** Ini bisa saja menjadi contoh: proyek untuk perangkat lunaknya sendiri, atau  untuk perubahan konfigurasi pada situs Wikimedia (lihat ).
 * 9) * Subscribers (Pengikut): Jika Anda kenal dengan pengguna spesifik yang mungkin berminat mendapatkan pemberitahuan mengenai tugas ini, Anda dapat menampahkan mereka di sini. Jika tidak, abaikan bidang ini.
 * 1) *** peramban web, kulit tema, atau sistem komputer di mana Anda menemukan kekutu ini;
 * 2) *** pranala atau riwayat versi ke satu atau lebih halaman di mana Anda menghadapi kekutu ini;
 * 3) *** apakah kendala ini muncul setiap kali, hanya sesekali, hanya pada halaman-halaman tertentu, atau hanya dalam situasi dan kondisi spesifik.
 * 4) * Untuk melampirkan sebuah berkas log atau (namun pastikan tidak ada data pribadi yang disertakan atau ditunjukkan), klik tombol Upload Files (Unggah Berkas) (awan dengan sebuah tanda panah) pada bilah alat di bidang Description.
 * 5) * Pilih Tags (satu atau lebih proyek) di mana Anda menemukan kekutu ini:
 * 6) ** Proyek merupakan cara pengembang menemukan tugas untuk dikerjakan. Untuk mengidentifikasi satu (atau lebih) proyek yang tepat, gunakan fungsi pencarian (di kanan atas) untuk menemukan deskripsinya.
 * 7) ** Ini bisa saja menjadi contoh: proyek untuk perangkat lunaknya sendiri, atau  untuk perubahan konfigurasi pada situs Wikimedia (lihat ).
 * 8) * Subscribers (Pengikut): Jika Anda kenal dengan pengguna spesifik yang mungkin berminat mendapatkan pemberitahuan mengenai tugas ini, Anda dapat menampahkan mereka di sini. Jika tidak, abaikan bidang ini.

Periksa apakah laporan Anda sudah lengkap, lalu tekan tombol "Create Task" (Buat Tugas). Laporan Anda akan sudah tersedia dalam basis data. Ini memungkinkan seseorang yang berminat pada laporan ini untuk memperhatikannya dan.

Prioritas untuk tugas ini akan ditetapkan oleh pengembang jika mereka berencana untuk mengerjakan tugas tersebut (lihat Menetapkan prioritas).

Selesai! Terima kasih atas bantuan Anda dalam meningkatkan proyek MediaWiki dan Wikimedia!



Melaporkan kekutu JavaScript

 * Lihat pula: 

Banyak fungsionalitas, seperti peralatan, skrip pengguna, dan beberapa bagian dari MediaWiki, yang mengandalkan JavaScript.

Ketika Anda menemui suatu kekutu yang mungkin terkait dengan JavaScript, lakukan semampu Anda untuk mengidentifikasi pesan galat dan salin mereka ke dalam laporan kekutu.

Sangatlah penting untuk menyertakan semua informasi yang Anda punya, karena bahkan pengurus sistem sekali pun tidak memiliki akses sama sekali ke log galat mana pun.

Jika kendalanya ada di dalam kode suatu skrip atau peralatan pengguna itu sendiri, maka Phabricator mungkin bukan merupakan tempat di mana kendala tersebut akan ditangani. Seseorang mungkin mengarahkan Anda ke halaman pembicaraan skrip tersebut (jika skrip yang berkendala berhasil teridentifikasi).



Melaporkan masalah konektivitas
Jika Anda mengalami kesulitan terhubung ke situs web Wikimedia sama sekali (koneksi internet yang lambat dll.), silakan ikuti [|wikitech:Melaporkan masalah konektivitas].



Melaporkan kendala masuk log
Jika Anda mengalami kendala dalam masuk log ke akun Anda, silakan ikuti.

Catatan


Lihat pula

 * Cara Melaporakan Kekutu dengan Efektif oleh Simon Tatham
 * Cara menjangkau komunitas pengembang untuk menyelesaikan kendala Anda, oleh User:MSchottlender-WMF, Juli 2017
 * Phabricator Wikimedia
 * Menulis laporan kekutu atau permintaan fitur yang baik
 * Cara menciptakan Laporan Kekutu pertama kali yang baik (usang)
 * Wikipedia bahasa Inggris: Laporan kekutu dan permintaan fitur
 * Cara menciptakan Laporan Kekutu pertama kali yang baik (usang)
 * Wikipedia bahasa Inggris: Laporan kekutu dan permintaan fitur