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.

Get up and running!

Jika anda baru membantu Django, tutorial Menulis tambalan pertama anda untuk 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.

If you are looking for a reference on the details of making code contributions, see the Penulisan kode documentation.

Langkah pertama

Mulai dengan langkah-langkah ini untuk menemukan pengolahan pengembangan Django.

• Tiket Triage

  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?

• Mencari tiket yang menerima dan meninjau tambalan untuk membangun keakraban dengan basiskode dan pengolahan

  Tandai bendera yang sesuai jika tambalan butuh dokumentasi atau percobaan. Liat melalui perubahan yang tambalan buat, dan awasi untuk sintaksis yang tidak sesuai dengan yang lama tetapi masih versi yang didukung Python. Run the tests dan pastikan mereka lolos. Dimana memungkinkan dan relevan, coba mereka pada basisdata selain SQLite. Tinggalkan komentar dan umpan balik!

• Tetap tambalan lama diperbaharui

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

• Tulis beberapa dokumentasi

  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.

• Tanda tangani Persetujuan Lisensi Penyumbang

  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.

• Ambil kawasan subjek yang abda peduli, yang anda akbrab, atau yang anda ingin pelajari

  Anda tidak harus menjadi ahli pada kawasan anda ingin kerjakan; anda menjadi seorang ahli melalui sumbangan berjalan anda pada kode.

• Analisa konteks & riwayat tiket-tiket

  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.

• Mulai kecil

  Hal ini lebih mudah mendapatkan umpanbalik pada masalah kecil daripada yang besar. Lihat easy pickings.

• Jika anda akan mengajak di tugas besar, apstikan bahwa ide andamempunyai dukungan terlebih dahulu

  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.

• Berani! Tinggalkan umpanbalik!

  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!

• Kesalahan pada sisi hati-hati ketika menandai hal-hal Ready For Check-in

  Jika anda tidak yakin jika sebuah tiket siap, jangan tandai begitu saja. Tinggalkan komentar sebagai gantinya, membiarkan orang lain mengetahui pikiran anda. Jika anda hampir yakin, tetapi tidak sepenuhnya yakin, anda mungkin juga mencoba menanyakan di IRL untuk melihat jika seseorang lain dapat menegaskan kecurigaan anda.

• Tunggu untuk umpanbalik, dan tanggapi untuk umpanbalik yang anda terima

  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.

• Menjadi keras

  Ketika kami katakan "PEP 8, dan harus mempunyai dokumen dan percobaan", kami bersungguh-sungguh. Jika tambalan tidak mempunyai dokumen dan percobaan, ada lebih baik untuk menjadi alasan baik. Argumen seperti "Saya tidak dapat menemukan percobaan yang ada dari fitur ini" jangan membawa terlalu berat--selagi itu mungkin benar, itu berarti anda mempunyai pekerjaan ekstra-penting dari menulis percobaan paling pertama untuk fitur itu, bukan yang anda dapatkan dari menulis percobaan semuanya.

FAQ

1. Tiket ini yang Saya peduli telah diabaikan untuk harian/mingguan/bulanan! Apa yang dapat Saya lakukan untuk mendapatkannya diperbaiki?

   First off, it's not personal. Django is entirely developed by volunteers (except the Django fellow), and sometimes folks just don't have time. The best thing to do is to send a gentle reminder to the django-developers mailing list asking for review on the ticket, or to bring it up in the #django-dev IRC channel.

2. **Saya yakin tiket saya sepenuhnya 100% sempurna, dapatkah Saya tandai itu sebagai RFC saya sendiri?

   Jawaban pendek: Tidak. Itu selalu lebih baik mendapatkan kumpulan mata lain pada tiket. Jika anda mempunyai masalah mendapatkan kumpulan mata kedua itu, lihat pertanyaan 1, diatas.