Reporting Bugs
**************

Python adalah bahasa pemrograman matang yang telah membangun reputasi
stabilitas. Untuk mempertahankan reputasi ini, pengembang ingin
mengetahui kekurangan apa yang ada temukan di Python.


Dokumentasi *bugs*
==================

Jika Anda menemukan *bug* di dalam dokumentasi atau berkeinginan untuk
mengusulkan sebuah perbaikan, mohon untuk mengajukan sebuah laporan
tentang bug di dalam tracker. Jika Anda memiliki sebuah saran
bagaimana cara untuk memperbaikinya, lampirkan juga.

Jika Anda tidak punya waktu, Anda juga dapat mengirim email laporan
dokumentasi bug ke docs@python.org (perilaku bugs juga dapat dikirim
ke python-list@python.org). 'docs@' adalah milis yang dijalankan oleh
sukarelawan; permintaan Anda akan diperhatikan, meskipun mungkin perlu
waktu beberapa saat untuk diproses.

lihat juga: Documentation bugs on the Python issue tracker


Menggunakan pelacak isu Python
==============================

Laporan bug untuk Python perlu dikirimkan melalui pelacak Bug Python
(https://bugs.python.org/).  Pelacak bug menyediakan sebuah formulir
Web dimana informasi terkait dapat dimasukkan kemudian dikirimkan ke
pengembang.

Langkah pertama mengarsipkan laporan adalah mengecek apakah masalah
telah dilaporkan.  Keuntungan dari melakukan hal tersebut, selain
menghemat waktu pengembang, adalah bahwa Anda telah mempelajari apakah
masalah telah diperbaiki; mungkin masalah telah diperbaiki untuk rilis
berikutnya, atau dibutuhkan tambahan informasi (dalam hal ini Anda
dipersilahkan untuk menyertakan yang Anda bisa!). Untuk melakukan ini,
cari di basis data bug menggunakan kotak pencarian di bagian atas
halaman.

Jika masalah yang anda laporkan belum ada di pelacak bug, kembali ke
pelacak bug Python dan masuk.  Jika Anda belum memiliki akun pelacak,
pilih tautan "Register", atau jika Anda menggunakan OpenID, pilih
salah satu logo penyedia OpenID di menu samping.  Tidak mungkin
mengirimkan laporan bug secara anonim.

Saat sudah masuk, Anda bisa mengirimkan *bug*. Pilih tautan "Create
New" di menu samping untuk membuka formulir laporan *bug*.

Formulir pengiriman memiliki sejumlah area. Untuk area "Title",
masukkan deskripsi *sangat* singkat dari permasalahan; baiknya kurang
dari 10 kata.  Di area "Type", pilih jenis masalah; juga pilih
"Component" dan "Versions" dimana terkait bug.

Di area "Comment", deskripsikan masalah dengan detil, termasuk apa
yang Anda harapkan terjadi dan apa yang saat ini terjadi.  Pastikan
untuk menyertakan apakah ada modul ekstensi yang terkait, dan platform
perangkat keras serta perangkat lunak yang digunakan (termasuk info
versi yang sesuai).

Setiap laporan bug akan diberikan kepada pengembang yang akan
menentukan apa yang perlu dilakukan untuk memperbaiki masalah.  Anda
akan menerima pembaruan setiap saat ada tindakan pada bug.

lihat juga:

  How to Report Bugs Effectively
     Artikel yang menyantumkan sejumlah detil tentang bagaimana
     membuat laporan bug yang berguna. Menjelaskan tentang sejumlah
     informasi yang berguna dan mengapa hal tersebut berguna.

  Bug Writing Guidelines
     Informasi tentang menulis laporan bug yang baik. Beberapa di
     antaranya khusus untuk proyek Mozilla, tapi secara umum
     menjelaskan praktik yang baik.


Mulai berkontribusi untuk Python
================================

Selain hanya melaporkan bugs yang Anda temukan, anda juga
dipersilahkan mengirim patch untuk memperbaikinya.  Anda dapat
menemukan informasi lebih lanjut mengenai bagaimana memulai
memperbaiki Python di Panduan Pengembang Python.  Jika Anda punya
pertanyaan-pertanyaan, milis core-mentorship adalah tempat yang ramah
untuk mendapatkan jawaban atas semua pertanyaan terkait proses
memperbaiki masalah di Python.
