Melaporkan kesalahan dan meminta fitur

Penting

Silahkan laporkan masalah keamanan hanya ke [e-mail]. Ini adalah daftar pribadi hanya buka ke waktu-panjang, sangat dipercaya pengembang Django, dan arsipnya tidak untuk umum. Untuk rincian lebih jauh, silahkan lihat our security policies.

Melaporkan kesalahan

Before reporting a bug on the ticket tracker consider these points:

• Check that someone hasn't already filed the bug report by searching or running custom queries in the ticket tracker.

• Don't use the ticket system to ask support questions. Use the Django Forum or the Django Discord server for that.

• Don't reopen issues that have been marked "wontfix" without finding consensus to do so on the Django Forum.

• Don't use the ticket tracker for lengthy discussions, because they're likely to get lost. If a particular ticket is controversial, please move the discussion to the Django Forum.

Penulisan-bagus laporan kesalahan adalah luar biasa sangat membantu. Bagaimanapun, ada jumlah tertentu dari atas ikut dalam bekerja dengan sistem pelacakan kesalahan apapun sehingga bantuan anda dalam menjaga pelacak tiket berguna mungkin sangat dihargai. Khususnya:

• Lakukan baca FAQ untuk melihat jika masalah anda mungkin menjadi pertanyaan dikenal.

• Do ask on Django Forum or the Django Discord server first if you're not sure if what you're seeing is a bug.

• Lakukan tulsi lengkap, dapat digandakan, laporan kesalahan khusus. anda harus mememasukkan jelas, gambaran ringkas dari masalah, dan mensetel petunjuk untuk menggandakan itu. Tambah sebanyak informasi mencari kesalahan anda bisa: potongan kode, kasus percobaan, pengecualian pelacakan kebelakang, tangkapan layar, dll. Sebuah kasus percobaan kecil yang bagus adalah cara terbaik untuk melaporkan kesalahan, itu memberikan kami cara membantu untuk mengkonfirmasi kesalahan dengan cepat.

• Don't post to Django Forum only to announce that you have filed a bug report. All the tickets are mailed to another list, django-updates, which is tracked by developers and interested community members; we see them as they are filed.

Untuk memahami siklus hidup tiket anda pertama anda telah membuatnya, mengacu ke Mendahulukan tiket.

Reporting user interface bugs

If your bug impacts anything visual in nature, there are a few additional guidelines to follow:

• Sertakan tampilan layar dalam tiket anda yaitu setara penglihatan dari uji kasus minimal. Pamerkan masalah, bukan penyesuaian gila anda telah buat ke perambah anda.

• Jika masalah sulit untuk ditunjukkan menggunakan gambar diam, pertimbangkan mengambil rekaman layar singkat. Jika perangkat lunak anda mengizinkannya, tangkap hanya kawasan yang sesuai dari layar.

• Jika anda sedang menawarkan tambalan sehingga merubah tampilan atau perilaku dari UI Django, anda harus melampirkan sebelum dan sesudah cuplikan layar/rekaman layar. Tiket melacak ini sangat sulit untuk mengurutkan untuk menilai dengan cepat.

• Cetak layar tidak membebaskan anda dari praktik pelaporan bagus. pastikan menyertakan URL, potongan kode, dan petunjuk langkah-demi-langkah pada bagaimana membuat kembali kebiasaan nampak dalam cetak layar.

• Pastikan menyetel bendera UI/UX pada tiket sehingga pihak tertarik dapat menemukan tiket anda.

Meminta fitur

Kami selalu mencoba membuat Django lebih baik, dan permintaan fitur anda adalah kunci bagian dari itu. Disini ada beberapa tip dalam bagaimana membuat permintaan paling efektif:

• Evaluate whether the feature idea requires changes in Django's core. If your idea can be developed as an independent application or module — for instance, you want to support another database engine — we'll probably suggest that you develop it independently. Then, if your project gathers sufficient community support, we may consider it for inclusion in Django.

• Propose the feature in the new feature ideas GitHub project (not in the ticket tracker) by creating a new item in the Idea column. This is where the community and the Steering Council evaluate new ideas for the Django ecosystem. This step is especially important for large or complex proposals. We prefer to discuss any significant changes to Django's core before any development begins. In some cases, a feature may be better suited as a third-party package, where it can evolve independently of Django's release cycle.

• Gambarkan dengan jelas dan secara singkat apa fitur yang hilang dan bagaimana anda ingin melihatnya diterapkan. Sertakan kode contoh (bukan-fungsional OKE) jika memungkinkan.

• Jelaskan mengapa anda menyukai fitur itu. Jelaskan kasus penggunakan minim akan membantu lainnya memahami dimana cocoknya, dan jika sudah ada cara lain untuk mencapai hal yang sama.

Lihat juga: Mendokumentasikan fitur baru.

Meminta optimalisasi penampilan

Laporkan penurunan penampilan, atau sarankan optimalisasi penampilan, harus menyediakan tolak ukur dan perintah untuk pemilah tiket untuk memproduksi ulang.

Lihat django-asv benchmarks untuk rincian lebih dari tolak ukur Django yang ada.

Bagaimana kita membuat keputusan

Whenever possible, we aim for rough consensus. Emoji reactions are used on issues within the new feature ideas GitHub project to track community feedback. The following meanings are assigned to each reaction:

• 👍: I support this feature and would use it

• 👎: I oppose this feature or believe it would cause issues for me or Django

• 😕: I have no strong opinion on this feature

• 🎉: This feature seems like a straightforward and beneficial addition

The Steering Council will regularly review the ideas in the project, moving those with community support through the following stages:

• Idea

• Approved - Idea refinement - Team creation

• In progress

• Working solution - Review - Feedback

• Needs maintainer (Django only)

• Done

Occasionally, discussions on feature ideas or the direction of Django may take place on the Django Forum. These discussions may include informal votes, which follow the voting style invented by Apache and used on Python itself, where votes are given as +1, +0, -0, or -1. Roughly translated, these votes mean:

• +1: "Saya cinta ide dan Saya sangat kuat melakukannya."

• +0: "Kedengarannya OKE buat saya."

• -0: "Saya tidak senang, tetapi Saya tidak berdiri di jalan."

• -1: "Saya sangat tidak setuju dan akan sangat tidah bahagia untuk melihat ide berubah menjadi kenyataan."

Meskipun pemungutan suara ini tidak resmi, mereka akan diambil secara serius. Setelah periode pemungutan suara cocok, jika konsensus yang jelas muncul, kami akan mengikuti pemungutan suara.