Jump to content

Cara melaporkan bug

pintasan: BUGREPORT
From mediawiki.org
This page is a translated version of the page How to report a bug and the translation is 97% complete.
Phabricator is for software bug reports, feature requests, and planning work.
  • To ask technical questions about Wikimedia projects, see m:Tech
  • To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

Panduan berikut menjelaskan cara menulis sebuah laporan kekutu atau permintaan fitur yang baik (task; tugas) di pelacak tugas Wikimedia (lihat Phabricator untuk informasi selengkapnya). Tugas yang ditulis dengan baik lebih dipilih untuk dikerjakan. Tugas harus ditulis dalam bahasa Inggris. Jika Anda tidak dapat menulis dalam bahasa Inggris, coba gunakan perkakas terjemahan mesin seperti Google Terjemahan.

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 pedoman yang telah disediakan 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.

Is it a caching issue?

Some issues relate to older cached HTML being served alongside newer JavaScript where the two are incompatible. To help determine if this is the cause it is helpful to purge the page, refresh the page and see if the issue persists and include this information in your bug report.

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 "Membuat akun anda ").
  3. Klik Bookmark button di pojok kanan atas dan pilih "Create Task" (atau "Report Security issues" untuk melaporkan kendala keamanan ).
  4. Isilah setidaknya bidang-bidang berikut:
    • Title (Judul): Sebuah ringkasan satu-kalimat pendek yang menjelaskan kendala tersebut (bukan solusi yang Anda sarankan)
      • Baik: "Selecting gender is not functional on Special:Preferences"
      • Buruk: "Software crashes"
    • 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:
      • Untuk kekutu:
        • 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. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • Hasil Kenyataan: Apa yang diperbuat aplikasi setelah melaksanakan langkah-langkah di atas.
          Contoh:
          "There is no female gender in front of my username."
        • Hasil Diharapkan: Apa yang seharusnya diperbuat aplikasi, jika tidak ada kekutu.
          Contoh:
          "My gender is shown in front of my username."
      • Untuk permintaan fitur:
        • 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:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • Harap sediakan juga informasi lainnya yang mungkin berguna, seperti:
        • peramban web, kulit tema, atau sistem komputer di mana Anda menemukan kekutu ini;
        • pranala atau riwayat versi ke satu atau lebih halaman di mana Anda menghadapi kekutu ini;
        • apakah kendala ini muncul setiap kali, hanya sesekali, hanya pada halaman-halaman tertentu, atau hanya dalam situasi dan kondisi spesifik.
    • Untuk melampirkan sebuah berkas log atau tangkapan layar (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.
    • Pilih Tags (satu atau lebih proyek) di mana Anda menemukan kekutu ini:
      • 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.
      • Ini bisa saja menjadi contoh: proyek MediaWiki-General untuk perangkat lunaknya sendiri, atau Wikimedia-Site-Requests untuk perubahan konfigurasi pada situs Wikimedia (lihat Selecting projects ).
    • 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 berpotensi mengerjakannya .

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: Help:Melacak skrip yang rusak

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.[1] 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 [masalah konektivitas].

Melaporkan kendala masuk log

Jika Anda mengalami kendala dalam masuk log ke akun Anda, silakan ikuti Manual:How to debug/Login problems .

Catatan

Lihat pula