FAQ: Kode Bantuan

Bagaimana dapat Saya mulai membantu kode ke Django?

Terima kasih untuk bertanya! Kami telah menulis seluruh dokumen setia untuk pertanyaan ini. Itu adalah berjudul Contributing to Django.

I submitted a bug fix several weeks ago. Why are you ignoring my contribution?

Jangan khawatir: Kami tidak mengabaikan anda!

Itu adalah penting untuk memahami ada perbedaan diantara "sebuah tiket yang diabaikan" dan "sebuah tiket yang belum dihadiri." Sistem tiket Django mengandung ratusan tiket terbuka, dari beragam tingkatan dari dampak pada kegunaan pengguna-akhir, dan pengembang Django harus meninjau kembali dan mengutamakan

Di atas semua itu: orang yang bekerja pada Django adalah semuanya sukarelawan. Sebagai hasilnya, sejumlah waktu yang kami harus kerjakan di kerangka adalah terbatas dan akan beragam dari minggu ke minggu tergantung waktu lenggang kami. Jika kami sibuk, kami mungkin tidak dapat menghabiskan waktu pada Django seperti yang kita inginkan.

Cara terbaik untuk memastikan tiket tidak menutup dalam perjalanan untuk memeriksa adalah membuatnya mudah mati, bahkan untuk seseorang yang tidak ingin dengan baik sekali akrab dengan kawasan dari kode, untuk memahami masalah dan memeriksa perbaikan:

• Apakah ada perintah jelas bagaimana memproduksi kembali kesalahan? Jika ini menyentuh ketergantungan (seperti Pillow), modul kontribusi, atau basisdata khusus, perintah tersebut cukup jelas bahkan untuk seseorang tidak akrab dengannya?
• If there are several branches linked to the ticket, is it clear what each one does, which ones can be ignored and which matter?
• Does the change include a unit test? If not, is there a very clear explanation why not? A test expresses succinctly what the problem is, and shows that the branch actually fixes it.

If your contribution is not suitable for inclusion in Django, we won't ignore it -- we'll close the ticket. So if your ticket is still open, it doesn't mean we're ignoring you; it just means we haven't had time to look at it yet.

When and how might I remind the team of a change I care about?

A polite, well-timed message in the forum/branch is one way to get attention. To determine the right time, you need to keep an eye on the schedule. If you post your message right before a release deadline, you're not likely to get the sort of attention you require.

Pengingat Gentle IRC dapa juga bekerja -- kembali, menurut rencana waktu jika memungkinkan. Selama sebuah kesalahan berlari cepat akan menjadi waktu bagus, sebagai contoh.

Another way to get traction is to pull several related tickets together. When someone sits down to review a bug in an area they haven't touched for a while, it can take a few minutes to remember all the fine details of how that area of code works. If you collect several minor bug fixes together into a similarly themed group, you make an attractive target, as the cost of coming up to speed on an area of code can be spread over multiple tickets.

Please refrain from emailing anyone personally or repeatedly raising the same issue over and over again. This sort of behavior will not gain you any additional attention -- certainly not the attention that you need in order to get your issue addressed.

But I've reminded you several times and you keep ignoring my contribution!

Seriously - we're not ignoring you. If your contribution is not suitable for inclusion in Django, we will close the ticket. For all the other tickets, we need to prioritize our efforts, which means that some tickets will be addressed before others.

Satu dari kriteria yang digunakan untuk mengutamakan perbaikan kesalahan adalah jumlah orang yang akan dipengaruhi oleh kesalahan yang diberikan. Kesalahan yang mempunyai kemungkinan untuk mempengarui banyak orang akan umumnya mendapatkan keutamaan disamping orang-orang yang kasusnya dipinggirkan.

Another reason that a bug might be ignored for a while is if the bug is a symptom of a larger problem. While we can spend time writing, testing and applying lots of little changes, sometimes the right solution is to rebuild. If a rebuild or refactor of a particular component has been proposed or is underway, you may find that bugs affecting that component will not get as much attention. Again, this is a matter of prioritizing scarce resources. By concentrating on the rebuild, we can close all the little bugs at once, and hopefully prevent other little bugs from appearing in the future.

Alasan apapun, harap perlu diingat bahwa selagi anda mungkin sering mengenai kesalahan tertentu, itu tidak perlu mengikuti bahwa setiap pengguna Django akan mengenai kesalahan sama. Pengguna berbeda menggunakan Django dalam cara berbeda, menekankan bagian berbeda dari kode dibawah kondisi berbeda. Ketika kami menilai prioritas hubungan, kami umumnya mencoba mempertimbangkan kebutuhan dari komunitas kelesuruhan, daripada mengutamakan dampak pada satu pengguna tertentu. Ini bukan berarti bahwa kami pikir masalah anda tidak penting -- hanya bahwa dalam waktu terbatas kami telah tersedia, kami akan selalu berbuat salah di sisi pembuatan dari membuat gembira 10 orang daripada membuat satu otang bahagia.

Saya yakin tiket saya sepenuhnya 100% sempurna, dapatkah Saya sendiri menandainya sebagai "Siap Untuk Daftar"?

Maaf, tidak. Selalu lebih baik untuk mendapatkan kumpulan mata pada tiket. Jika anda sedang memiliki masalah kumpulan kedua tersebut dari mata, lihat pertanyaan-pertanyaan diatas.