# Dokumentasi Django 6.0.7

# Melaporkan kesalahan dan meminta fitur

Penting

Please report security issues only to `security@djangoproject.com`. This is a private list only open to long-time, highly trusted Django developers, and its archives are not public. For further details, please see our security policies.

## Melaporkan kesalahan

Sebelum melaporkan sebuah kesalahan pada ticket tracker pertimbangkan hal ini:

- Periksa bahwa seseorang belum memberkaskan laporan kesalahan dengan searching atau running custom queries di pelacak tiket.

- Jangan menggunakan sistem tiket untuk meminta dukungan pertanyaan. Gunakan Django Forum atau the Django Discord server untuk itu.

- Jangan membuka kembali masalah yang telah ditandai "wontfix" tanpa menemukan pemufakatan utnuk melakukannya di Django Forum.

- Don't reopen issues that have been marked "needsnewfeatureprocess" without shepherding an issue through the new feature ideas GitHub project.

- Jangan menggunakan pelacak tiket untuk memperpanjang obrolan, karena mereka mungkin tersesat. Jika tiket tertentu kontroversial, harap pindahkan obrolan ke 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.

- Lakukan tanya Django Forum atau Django Discord server dahulu jika anda tidak yakin jika anda yang lihat adalah sebuah kesalahan.

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

- Jangan menulis ke Django Forum hanya untuk mengumumkan bahwa anda telah memberkaskan sebuah laporan kesalahan. Semua tiket disuratkan ke daftar lain, django-updates, yang dilacak oleh pengembang dan anggota komunitas yang berminat; kami melihat mereka ketika mereka memberkaskan.

To understand the lifecycle of your ticket once you have created it, refer to Alur kerja Triage.

### Melaporkan kesalahan antarmuka pengguna

Jika kesalahan anda memengaruhi apa pun yang bersifat visual, ada beberapa panduan tambahan 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.

- If the issue relates to accessibility, please link to the relevant accessibility standard if applicable.

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

- Nilai apakah ide fitur membutuhkan perubahan di inti Django. Jika ide anda dapat dikembangkan sebagai aplikasi atau modul berdiri sendiri — misalnya, anda ingin mendukung mesin basisdata lain — kami mungkin akan menyarankan anda mengembangkannya berdiri sendiri. Kemudian,jika proyek anda mendapatkan dukungan komunitas yang memadai, kami akan mempertimbangkannya untuk dimasukkan di 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 Tolok ukur django-asv untuk rincian lebih dari tolak ukur Django yang ada.

## Bagaimana kita membuat keputusan

Kapanpun memungkinkan, kami bertujuan untuk mencapai konsensus kasar. Reaksi emoji digunakan pada masalah-masalah dengan proyek Github new feature ideas untuk melacak umpan balik pelanggan. Arti berikut ditujukan untuk setiap reaksi:

- 👍: Saya mendukung fitur ini dan akan menggunakannya

- 👎: Saya menentang fitur ini atau mempercayainya akan menyebabkan masalah untuk saya atau Django

- 😕: Saya memiliki pendapat kuat pada fitur ini

- 🎉: Fitur ini tampaknya merupakan tambahan yang mudah dan bermanfaat

Steering Council akan berkala meninjau kembali ide di proyek, memindahkan mereka dengan dukungan komunitas melalui tahapan berikut:

- Ide

- Disetujui - Penyempurnaan ide - Pembentukan tim

- Dalam kemajuan

- Pemecahan pekerjaan - Tinjauan - Umpan balik

- Dibutuhkan perawat (hanya Django)

- Selesai

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.

## How to test pre-release versions of Django

Testing pre-releases is a great way to contribute to Django. Early testers help catch bugs before the final release, ensuring a smoother upgrade experience for everyone.

### Prasyarat

Before testing a pre-release, it is important that your project is running smoothly on the latest stable release of Django. That way, any regressions can be attributed to the pre-release. See the Bagaimana meningkatkan Django ke versi terbaru guide for instructions on getting up to date.

To ensure your project is ready, you should also:

- Read the release notes: Review the Catatan terbitan for the upcoming version to learn about upgrade paths for deprecated features or about minor backward-incompatible changes.

- Resolve deprecation warnings: Run your tests with deprecation warnings enabled to become aware of required follow-up actions:

      $ python -Wa manage.py test

### Testing your project

You can install the latest pre-release using `pip`:

    $ python -m pip install --pre Django

Once installed, run your project's test suite. Rather than just checking if tests pass, try the following:

- Check dependency support: Determine whether major dependencies support the new version by checking Django version classifiers on PyPI. Since those projects also value early bug reports, don't let a lack of support prevent you from testing.

- Monitor performance: You can run your tests with the `test --durations` flag to identify potential performance regressions.

- Automate tests in CI: Consider running your Continuous Integration (CI) pipeline with the pre-release version.

- Test manually: While automated tests are great, manually testing your application's main workflows is an important part of verifying compatibility with a new release.

### Reporting issues

If you discover a bug, please report it via the Django issue tracker so it can be fixed before the final release. When creating the ticket, be sure to set the Django version field to the exact pre-release version you are testing.

If you suspect a regression, it's helpful to report the specific commit that caused it. See Membagi dua pemulihan for instructions.

You can also discuss any issues or share feedback in the Pre-releases category on the Django Forum.