JM/PelaporanKutu
TDF LibreOffice Document Liberation Project Blog Komunitas Penerjemah Weblate Nextcloud Redmine Tanya LibreOffice Donasi
Senang Anda ke sini. Anda akan memberikan kontribusi penting kepada LibreOffice. Laporan kutu yang bagus sangat membantu pengembang kami. Di bawah ini, Anda akan menemukan beberapa panduan untuk membuat proses ini lebih mudah.
Tidak semua kutu harus dilaporkan ke Bugzilla
Berikut ini Bbeberapa laporan kutu harus diajukan di luar Bugzilla:
| Kelas Kutu | Tempat melaporkan kutu |
|---|---|
| Ekstensi LibreOffice | With the extension author |
| Infrastruktur TDF/LibreOffice (situs web, milis, dan lain sebagainya) | Redmine |
| Mem-build LibreOffice | Developer mailing list |
| LibreOffice Unit Tests | Developer mailing list |
| Words missing from dictionaries | To the dictionary maintainer or repository |
| Mistakes in translations | Reporting them in Bugzilla is allowed, but it is more efficient to add them as suggestions in Weblate (does not require registration) |
Sebelum Anda mengirimkan kutu
Konfirmasikan bahwa ini memang benar kutu. Seringkali, kutu adalah sesuatu yang membuat perangkat lunak berperilaku sedemikian rupa sehingga pengguna yang wajar tidak ingin dia berperilaku seperti itu. Hal ini termasuk perangkat lunak yang tidak melakukan apa yang Anda inginkan, melakukan apa yang Anda tidak pernah diminta untuk melakukannya, atau hanya crash di saat penggunaan normal. Di balik layar, kutu mungkin menjadi sesuatu yang menyebabkan perangkat lunak lebih lama dan menggunakan lebih banyak sumber daya dalam melakukan hal-hal yang sewajarnya.
Beberapa gangguan mungkin sebenarnya hasil dari profil pengguna yang rusak. Masalah dengan OpenGL and OpenCL biasanya kutu yang absah. Ini sangat membantu, jika Anda memeriksa efek pengaturan OpenGL dan OpenCL sebelum menulis laporan kutu Anda.
Pada keadaan tertentu apa yang tampak seperti kutu sebenarnya lebih seperti permintaan fitur, di mana kita tahu bagaimana semestinya perangkat lunak bekerja di dunia yang ideal, meskipun fitur yang kita inginkan belum dibangun. Untungnya, Anda tidak perlu terlalu khawatir tentang memisahkan kutu dari permintaan fitur. Jika itu adalah sesuatu yang mengganggu penggunaan aplikasi yang normal dan absah, laporkan sebagai kutu.
Akan sangat membantu jika Anda tahu bagaimana LibreOffice bekerja, jadi Anda memiliki pemahaman yang baik tentang apa yang normal dan juga bagaimana penggunaan yang absah. Anda tidak ingin menghabiskan banyak waktu melaporkan apa yang Anda anggap sebagai kutu ketika masalahnya adalah justru Anda belum tahu cara menggunakan fitur tertentu. Pertimbangkan membaca dokumentasi pengguna, dan gunakan aplikasi sesering mungkin sehingga Anda menjadi terbiasa dengan perilaku aplikasi.
Jika Anda mengetahui LibreOffice dengan cukup baik dan mengalami sesuatu yang mungkin merupakan kutu, tetapi mungkin hanya sesuatu yang tidak Anda mengerti, Anda dapat memposting pertanyaan di Milis Pengguna LibreOffice atau Ask LibreOffice.
Katakanlah apa yang Anda temukan benar-benar terlihat seperti kutu. Inilah yang harus dilakukan selanjutnya:
- Catatlah sehingga Anda tidak lupa apa yang terjadi saat kutu muncul. Apa yang Anda lakukan, dan apa yang sebenarnya terjadi? Bagaimana Anda tau sesuatu itu keliru? Dapatkah Anda membuat ulang perilaku yang tidak pas tersebut?
- Periksa, laporan kutu yang sudah ada yang kira-kira mirip:
- Pergi ke Components, lalu pilih component atau subcomponent yang sesuai.
- Jika Anda memilih sebuah component: pilih subcomponent yang sesuai atau pilih Extended Help jika Anda tidak melihat subcomponent pada halaman.
- Jika Anda memilih Extended Help: pilih subcomponent yang sesuai, atau [1] pada daffar paling bawah jika Anda tidak menemukan atau tidak mengetahui subcomponent yang sesuai.
- Anda akan melihat daftar kutu dengan subcomponent tersebut. Pada bagian paling bawah halaman, pilih Edit Search. Dari situ, Anda dapat mengubah pencarian sesuai kebutuhan.
- Jika Anda tidak menemukan laporan kutu yang menjadi masalah Anda, ajukan laporan kutu baru.
- Jika kutu hanya muncul pada Ubuntu atau terkait printing, pilih #Informasi Lebih Lanjut.
- Setelah semuanya selesai, jika dilihat tidak ada laporan kutu terkait isu ini, ikuti petunjuk pada #Mengirimkan kutu.
Mengirimkan kutu
Ajukan laporan kutu terpisah untuk masing-masing kutu yang Anda temui, walaupun gejalanya dari sisi pengguna terlihat identik. Permasalahan yang berbeda dengan akar yang berbeda yang muncul pada versi LibreOffice yang berbeda mungkin saja harus diselesaikan oleh orang yang berbeda, untuk versi yang berbeda dan pada saat waktu yang berbeda. Sangat mustahil melacak semua itu dalam satu laporan kutu saja.
Pergi ke Bugzilla.
Masuk log
Jika Anda diminta untuk masuk log, masuklah dengan akun Bugzilla Anda.
If you don't have a Bugzilla account, create one by clicking New Account.
Component
Pada "Component", pilih component.
Jika Anda tidak yakin component mana yang menjadi masalah Anda, pilih LibreOffice. Seseorang akan meninjau laporan kutu tersebut di lain waktu dan akan memilihkan component yang lebih tepat. (Untuk informasi lebih lanjut tentang triage, yaitu peninjauan kutu untuk melihat yang paling penting menjadi yang teratas dalam daftar, coba lihat "TriaseKutu".)
Jika temuan ini merupakan masalah yang mendesak (bagian yang rusak, regresi, dan sebagainya) dan Anda adalah pengguna berpengalaman yang mengetahui tim pengembangan, Anda dapat menetapkan laporan kutu ke salah satu pengembang yang terdaftar di halaman FindTheExpert.
Rincian
Jika ada bagian Sub-component, pilih subcomponent.
Jika Anda tidak tahu subcomponent yang sesuai, buka Components. Pada halaman tersebut, klik pada component yang sesuai. Baca penjelasan semua subcomponent pada halaman component tersebut. Jika Anda tidak melihat subcomponent yang sesuai, klik Extended Help, dan baca penjelasan subcomponent di halaman tersebut.
Pilih versi aplikasi tempat bug muncul. Untuk memeriksa versi LibreOffice apa yang Anda gunakan, pilih ▸
Di Operating system atau OS , pilih sistem operasi komputer yang Anda gunakan ketika Anda menemukan kutu.
Jika ada bagian Hardware, maka isilah.
Jika ada bagian Severity , abaikan saja kecuali Anda berpengalaman. Memilih Blocker tidak akan mempercepat kutu untuk diperbaiki. Jika Anda ingin mengetahui makna butir di bagian Severity, lihat bagan ini.
Anda dapat mengabaikan bagian versi terbaru yang diketahui bekerja.
Subject
Periksa di tabel possibly related Bugs pada halaman pelaporan bug dan tambahan di Duplicates Table untuk melihat apakah masalah sebenarnya belum dilaporkan.
Pada bagian Subject (disebut juga sebagai Summary):
- Jangan sertakan informasi yang sudah diketahui dari field.
- Sertakan nama-nama subcomponent dari Components.
- Buat subcomponent dengan huruf besar.
- Jika subcomponent dapat dikacaukan dengan bagian kata (misalnya, UI adalah bagian dari kata d'uit), tutup subcomponent dengan tanda kurung siku.
- Gunakan paling banyak dua subcomponent.
- Gunakan subcomponent persis seperti yang muncul dalam daftar, tetapi Anda dapat mengintegrasikannya ke dalam kalimat baris subjek seperti "WIKIHELP [UI] tidak tersedia dalam semua bahasa".
- Rangkum masalah dengan tepat.
- contoh buruk: "Berkas rusak"
- contoh yang lebih baik: "Menu Berkas> Simpan sebagai tidak tersedia (menjadi nonaktif)"
- Hindari bentuk pendek seperti "yg" atau "dsb" untuk memudahkan kueri untuk string dalam Summary; alih-alih, gunakan formulir lengkap, seperti "yang" atau "dan sebagainya".
- Jika masalah yang ditulis dalam laporan adalah LibreOffice crash atau berhenti menanggapi ("hang"), tambahkan kata CRASH ke Summary, sehingga kutu ini dapat ditemukan dan dilacak dengan mudah.
Penjelasan dan lampiran
Pada bagian Long Description atau Description, berikan penjelasan masalah yang lebih lengkap dan faktual:
- tuliskan daftar langkah-langkah untuk mereproduksi bug;
- menggunakan daftar bernomor; dan
- nyatakan metode yang tepat untuk membuat sesuatu terjadi. Misalnya, alih-alih menulis "Buka dokumen", tulis "Di dokumen LibO Spreadsheet kosong yang baru, gunakan menu Berkas > Buka (dialog LibO)> jenis file "Dokumen teks" > pilih dokumen sampel terlampir > klik dua kali".
Jika Anda menggunakan LibreOffice yang sudah dibuat sebelumnya di Linux, daftarkan versi yang tepat dari paket LibreOffice di sistem manajemen paket Anda. Jika Anda menggunakan Windows, daftarkan nama berkas persis dari pemasang, dan dari mana diunduh.
- Termasuk informasi tentang lokalisasi yang dipasang dan digunakan (bahasa antarmuka, bahasa dokumen) mungkin berguna.
- Sertakan apakah LibreOffice 32-bit digunakan pada sistem 64-bit (Linux).
- Masukkan sumber paket jika bukan build LibreOffice resmi.
Tulis perilaku yang diharapkan dan perilaku yang terjadi.
Anda dapat menyertakan lampiran, seperti tangkapan layar atau dokumen contoh. Cara khas untuk mengambil tangkapan layar adalah dengan menekan tombol "Print Screen/PrtScn" di papantik. Tergantung pada sistem operasi Anda, Anda mungkin harus membuka aplikasi pengeditan gambar (seperti Paint on Windows) dan lakukan Edit - Paste di dalamnya.
- Jika Anda membuat tangkapan layar, alihkan bahasa ke Bahasa Inggris sebelum membuat tangkapan layar. Anda dapat melakukannya di ▸ ▸ ▸ .
- Anda dapat membuat tangkapan layar lebih bermanfaat dengan menambahkan komentar dan menandai area yang relevan dengan LibreOffice Draw.
- Jika Anda ingin melampirkan lebih dari satu tangkapan layar, Anda harus mengumpulkan semuanya dalam satu dokumen (salin / tempel ke dokumen LibreOffice Draw) dan lampirkan sebagai PDF. Silakan tambahkan komentar singkat ke setiap tangkapan layar untuk memberi tahu apa yang ingin Anda tunjukkan dengannya.
- Jika Anda melampirkan dokumen contoh yang menunjukkan kutu yang Anda laporkan, harap buat dokumen seminimal mungkin. Misalnya, untuk kutu Writer, dokumen idealnya hanya memiliki satu paragraf. Untuk memudahkan menemukan teks dari dokumen Anda dalam penelusuran debug, gunakan beberapa teks yang sangat mudah dikenali, seperti AAAAAAAAAAA ₂ ZZZZZZZZZZZ untuk kutu yang dipicu oleh karakter itu.
- Utamakan untuk mengunggah lampiran satu per satu. Namun, jika Anda ingin melampirkan banyak dokumen, kumpulkan dokumen dalam berkas .zip dan lampirkan .zip tersebut.
- Jika lampiran Anda terlalu besar untuk dilampirkan di Bugzilla (lebih dari 1 MB), Anda dapat menggunakan Halaman unggahan eksperimental.
Status
Satu-satunya waktu yang tepat Anda harus mengubah status menjadi NEW adalah jika seseorang sudah mengkonfirmasi kutu di tempat lain (Ask, milis, beberapa forum). Dalam kasus ini, berikan tautan ke diskusi dengan konfirmasi.
Submit
Klik Submit, dan laporan Anda akan ditambahkan ke basis data Bugzilla.
Jika Bugzilla nampak menakutkan
Jika sistem pelacakan kutu Bugilla tampaknya menakutkan atau terlalu sulit untuk dipahami, Anda sebaiknya memposting masalah Anda di sini:
Bahkan jika Anda memposting masalah Anda di saluran-saluran tersebut, tujuan Anda seharusnya adalah untuk mendapatkan laporan kutu yang bagus pada bugzilla. Saluran-saluran di atas mungkin membantu Anda dengan hal tersebut. Perhatikan, bahwa melaporkan masalah di media sosial (Facebook, Twitter, dan sebagainya) secara umum tidak produktif karena jarang menyebabkan laporan kutu yang bagus yang berakhir di bugzilla (lihat juga: 99 cara untuk merusak proyek sumber terbuka, top 5).
Setelah Anda mengirimkan laporan kutu
Jika tidak ada seorangpun yang meninjau laporan Anda dalam rentang waktu tertentu (24 jam untuk bug kritikal, 14 hari untuk permintaan peningkatan), pertimbangkan untuk meminta orang lain mereproduksi laporan kutu Anda di Internet users@global.libreoffice.org milis atau kanal IRC #libreoffice IRC://.
Menambahkan komentar ke laporan kutu
- Hindari memposting komentar "saya juga" yang tidak mengandung informasi tambahan yang bermanfaat.
Pengecualian untuk ini adalah ketika Anda mengomentari kutu yang masih UNCOFIRMED sejauh ini. Dalam hal ini, harap sediakan langkah-langkah reproduksi (atau konfirmasi yang diberikan oleh pelapor asli) dan pindahkan masalah ke status NEW. Perhatikan bahwa jika tidak ada langkah-langkah reproduksi yang jelas, masalah ini mungkin dengan cepat kembali ke NEEDINFO, sehingga menemukan skenario reproduksi yang baik dan sederhana sangatlah penting. - Jangan menambahkan komentar di sepanjang baris “kami memiliki 1.000 kursi di sini dan hanya kutu ini yang mencegah kami bermigrasi”, karena tidak ada informasi tambahan yang relevan dengan QA atau prioritas masalah ini.
LibreOffice adalah produk kode sumber terbuka dan bantuan Anda untuk memperbaiki masalah yang relevan dengan situasi khusus Anda sangat kami hargai. Anda bisa melakukan hal-hal berikut:
- Mempekerjakan dan atau mengajarkan pengembang Anda sendiri untuk bekerja untuk peningkatan LibreOffice. Kami sangat senang untuk membimbing mereka: lihat halaman pengembang.
- Mendanai individu atau perusahaan untuk menangani masalah-masalah spesifik - lihat daftar pengembang bersertifikat.
- Kontak The Document Foundation untuk membantu Anda jika Anda hanya memiliki sedikit dana, dan ingin berkolaborasi, mengordinasikan atau menyatukan sumber daya Anda dengan orang lain dalam situasi yang sama untuk mendanai perbaikan atau peningkatan khusus.
Laporan yang Baik
Persyaratan Minimal
- Versi OS/LibreOffice;
- menyebutkan langkah-langkah yang dapat direproduksi;
- lampiran sederhana jika diperlukan; dan
- hasil yang diamati/diharapkan.
Contoh yang Baik
- tdf#85004 - Writer: Crash when clicking the Reminder icon on the Navigation toolbar
- tdf#87907 - DIALOG: Page preview in print dialog refreshes when opening print details
- tdf#74839 - EDITING: Position of connectors connected to a group aren't updated when editing group content
Contoh Laporan Kurang Baik
Laporan bisa jadi kurang ideal karena sejumlah alasan. Di bawah ini adalah beberapa masalah umum:
Paragraf atau Teks
Menjelaskan laporan kutu dalam paragraf teks adalah salah satu masalah yang paling umum. Pengembang tidak punya waktu untuk membaca paragraf teks, lebih baik tuliskan langkah-langkah yang jelas dan ringkas.
Satu Laporan, Lima Kutu
Satu laporan haruslah hanya memiliki satu kutu di dalamnya. Mengelompokkan kutu, atau mendaftar seluruh daftar masalah dengan satu dokumen, sama sekali tidak membantu. Dalam rangka menemukan pengembang untuk mengatasi masalah, yang terbaik adalah memberi mereka satu masalah untuk fokus. Mereka tidak mungkin mengambil kutu yang memiliki banyak masalah terdaftar
Rincian atau Langkah yang Kurang
Semua laporan kutu harus memiliki minimal:
- Sistem Operasi Anda dan versi LibreOffice;
- langkah-langkah yang dapat direproduksi yang jelas;
- hasil yang diharapkan;
- hasil yang diamati; dan
- lampiran sederhana yang sesuai.
Menambahkan Informasi yang Berlebihan
Menambahkan banyak rincian tambahan yang tidak relevan adalah masalah umum lainnya. Contohnya termasuk:
- "Ini adalah pemblokir";
- daftar panjang alasan mengapa ini adalah pemblokir;
- "Saya tidak bisa menggunakan LibreOffice karena kutu ini";
- "LibreOffice menyebalkan" (atau sejenisnya); dan
- Saya akan mulai menggunakan pesaing Anda kecuali jika Anda memperbaikinya.
Lampiran Rumit
Lampiran harus dibuat sesederhana mungkin. Luangkan waktu untuk memangkas contoh Anda seminimal mungkin. Ini sangat membantu dalam mendiagnosis masalah.
Mempunyai Dugaan Kontributor Tahu Segalanya
Jangan menganggap kontributor tahu apa yang Anda bicarakan. Jelaskan langkah-langkah Anda dengan jelas, setiap langkah.