Melaporkan kesalahan dan meminta fitur¶

Melaporkan kesalahan¶

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.

Melaporkan kesalahan antarmuka pengguna dan fitur¶

Jika kesalahan atau fitur anda menyentuh pada apapun penglihatan dalam alami, terdapat beberapa tambahan panduan untuk diikuti:

• 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:

• Pastikan fitur sebenarnya membutuhkan perubahan dalam inti Django. Jika ide anda dapat dikembangkan sebagai aplikasi berdiri sendiri atau modul - contohnya, anda ingin mendukung mesin basisdata lain - kamia kan mungkin menyarankan anda mengembangkan itu secara mandiri. kemudian, jika proyek anda mendapatkan dukungan komunitas cukup, kami mungkin mempertimbangkan itu untuk disertakan di Django.

• First request the feature on the Django Forum, not in the ticket tracker. It'll get read more closely and reach a larger audience. This is even more important for large-scale feature requests. We like to discuss any big changes to Django's core before actually working on them.

• 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.

Jika ada sebuah persetujuan pemufakatan pada fitur, kemudian itu adalah sesuai untuk membuat sebuah tiket. Sertakan sebuah tautan obrolan pada gambaran tiket.

Seperti dengan kebanyakan proyek sumber-terbuka, kode berbicara. Jika anda ingin menulis kode untuk fitur itu sendiri atau, bahkan lebih baik, jika anda teah menulisnya, itu jauh lebih mungkin diterima. Cabangkan Django pada GitHub, buat sebuah fitur, dan tunjukkan kami kerja anda!

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 strive for a rough consensus. To that end, we'll often have informal votes on the Django Forum about a feature. In these votes we 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.

However, consensus is not always possible. If consensus cannot be reached, or if the discussion toward a consensus fizzles out without a concrete decision, the decision may be deferred to the steering council.

Secara internal, dewan pengarah akan menggunakan mekanisme pemilihan sama. Saran akan dianggap dilakukan jika:

• Ada setidaknya tiga pilihan "+1" dari anggota dewan pengarah..

• Tidak ada pilihan "-1" dari setiap anggota dewan pengarah.

Pemungutan suara harus diajukan dalam minggu ini.

Since this process allows any steering council member to veto a proposal, a "-1" vote should be accompanied by an explanation of what it would take to convert that "-1" into at least a "+0".

Votes on technical matters should be announced and held in public on the Django Forum.