Saran untuk penyumbang baru¶
Peyumbang baru dan tidak yakin apa yang harus dilakukan? Ingin membantu tetapi tidak tahu bagaimana memulai? Ini adalah bagian untuk anda.
Bangun dan berjalan!
Jika anda baru membantu Django, tutorial Writing your first contribution for Django akan memberikan anda sebuah perkenalan ke alat dan alurkerja.
This page contains more general advice on ways you can contribute to Django, and how to approach that.
Jika anda mencari acuan pada rincian dari membuat bantuan kode, lihat dokumentasi Kode bantuan.
Langkah pertama¶
Mulai dengan langkah-langkah ini untuk menemukan pengolahan pengembangan Django.
Triage tickets¶
Jika unreviewed ticket melaporkan kesalahan, coba untuk memproduksi ulang. Jika anda dapat memproduksi ulang dan terlihat sah, buat catatan bahwa anda menegaskan kesalahan dan menerima tiket. Pastikan tiket diisi dibawah kawasan komponen yang benar. Pertimbangkan menulis tambalan yang menambahkan percobaan untuk kebiasaan kesalahan, bahkan jika anda tidak memperbaiki kesalahan itu sendiri. Lihat lebih pada Bagaimana saya dapat membantu dengan penyortiran?
Review patches of accepted tickets¶
This will help you build familiarity with the codebase and processes. Mark the appropriate flags if a patch needs docs or tests. Look through the changes a patch makes, and keep an eye out for syntax that is incompatible with older but still supported versions of Python. Run the tests and make sure they pass. Where possible and relevant, try them out on a database other than SQLite. Leave comments and feedback!
Keep old patches up-to-date¶
Seringkali dasar kode akan berubah diantara tambalan sedang diajukan dan waktu itu mendapatkan tinjauan. Pastikan itu masih bersih dan berfungsi sesuai harapan. memperbaharui tambalan adalah membantu dan penting! Lihat lebih pada Mengajukan bantuan.
Write some documentation¶
Dokumentasi Django sangat hebat tetapi itu dapat selalu diperbaiki. Dpakah anda menemukan kesalahan ketik apapun? Apakah anda pikir bahwa sesuatu harus dijelaskan? Pergilah dan sarankan tambalan dokumentasi! Lihat juga panduan pada Menulis dokumentasi.
Catatan
reports page megnandung tautan ke banyak permintaan Trac berguna, termasuk beberapa yang berguna untuk mendhulukan tiket dan menilai tambalan seperti disarankan diatas.
Sign the Contributor License Agreement¶
Kode yang anda tulis milik anda atau majikan anda. Jika sumbangan anda lebih dari satu atau dua baris kode, anda butuh menandatangani CLA. Lihat Contributor License Agreement FAQ untuk untuk penjelasan lebih tuntas.
Panduan¶
Sbagai seorang pendatang baru pada proyek besar, sangat mudah mengalami frustasi. Ini adalah beberapa saran untuk membuat pekerjaan anda pada Django lebih berguna dan bermanfaat.
Pick a subject area¶
This should be something that you care about, that you are familiar with or that you want to learn about. You don't already have to be an expert on the area you want to work on; you become an expert through your ongoing contributions to the code.
Analyze tickets' context and history¶
Trac tidak mutlak; konteks hanya sama pentingnya dengan kata-kata. Ketika membaca Trac, anda perlu memperhitungkan siapa mengatakan hal-hal, dan kapan mereka katakan. Dukungan untuk sebuah ide dua tahun lalu tidak berarti bahwa ide akan masih mempunyai dukungan. Anda juga butuh perhatian ke siapa belum bicara -- sebagai contoh, jika seorang pembantu berpengalaman belum saat ini terlibat dalam sebuah obrolan, kemudian sebuah tiket mungkin tidak memiliki dukungan yang butuhkan untuk masuk ke dalam Django.
Start small¶
Hal ini lebih mudah mendapatkan umpanbalik pada masalah kecil daripada yang besar. Lihat easy pickings.
Confirm support before engaging in a big task¶
Ini berarti mendapatkan seseorang lain untuk menegaskan bahwa sebuah kesalahan adalah nyata sebelum anda memperbaiki masalah, dan memastikan bahwa ada pemufakatan pada fitur yang diajukan sebelum anda pergi menerapkan itu.
Be bold! Leave feedback!¶
Terkadang itu dapat menakutkan untuk menaruh pendapat anda ke dunia dan mengatakan "tiket ini benar" atau "tambalan ini butuh bekerja", tetapi itu hanya jalan proyek maju kedepan. Sumbangan dari komunitas luas Django akhirnya mempunyai dampak yang lebih hebat daripada satu orang. Kami tidak dapat melakukannya tanpa anda!
Be cautious when marking things "Ready For Check-in"¶
If you're really not certain if a ticket is ready, don't mark it as such. Leave
a comment instead, letting others know your thoughts. If you're mostly certain,
but not completely certain, you might also try asking on the
#contributing-getting-started channel in the Django Discord server to
see if someone else can confirm your suspicions.
Wait for feedback, and respond to feedback that you receive¶
Jika anda tidak yakin jika tiket sudah siap, jangan menandainya. Tinggalkan komentar sebagai gantinya, membiatkan lainnya mengetahui pikiran anda. Jika anda sangat yakin, tetapi tidak sepenuhnya yakin, anda mungkin juga coba menanyakan pada IRC untuk melihat jika lainnya dapat menegaskan kecurigaan anda.
Be rigorous¶
When we say "PEP 8, and must have docs and tests", we mean it. If a patch doesn't have docs and tests, there had better be a good reason. Arguments like "I couldn't find any existing tests of this feature" don't carry much weight. While it may be true, that means you have the extra-important job of writing the very first tests for that feature, not that you get a pass from writing tests altogether.
Be patient¶
It's not always easy for your ticket or your patch to be reviewed quickly. This isn't personal. There are a lot of tickets and pull requests to get through.
Keeping your patch up to date is important. Review the ticket on Trac to ensure that the Needs tests, Needs documentation, and Patch needs improvement flags are unchecked once you've addressed all review comments.
Remember that Django has an eight-month release cycle, so there's plenty of time for your patch to be reviewed.
Akhirnya, pengigat waktu-baik dapat membantu. Lihat contributing code FAQ untuk ide disini.
