Cara berkontribusi

Kami ingin menerima patch dan kontribusi Anda untuk project ini. Hanya ada beberapa panduan kecil yang perlu Anda ikuti.

Perjanjian Lisensi Kontributor

Kontribusi ke project Google apa pun harus disertai dengan Perjanjian Lisensi Kontributor. Ini bukanlah penugasan hak cipta, melainkan hanya memberi Google izin untuk menggunakan dan mendistribusikan ulang kontribusi Anda sebagai bagian dari project.

  • Jika Anda adalah individu yang menulis kode sumber asli dan yakin bahwa Anda adalah pemilik kekayaan intelektual, Anda harus menandatangani CLA individual.

  • Jika Anda bekerja untuk perusahaan yang ingin mengizinkan Anda memberikan kontribusi, Anda harus menandatangani CLA perusahaan.

Biasanya, Anda hanya perlu mengirimkan CLA satu kali, jadi jika sudah mengirimkannya (meskipun untuk project lain), Anda mungkin tidak perlu melakukannya lagi.

Mengirimkan patch

  1. Secara umum, sebaiknya mulai dengan membuka masalah baru yang mendeskripsikan bug atau fitur yang ingin Anda perbaiki. Meskipun menurut Anda relatif kecil, ada baiknya untuk mengetahui apa yang sedang dikerjakan orang-orang. Sebutkan di masalah awal bahwa Anda berencana untuk menangani bug atau fitur tersebut agar dapat ditetapkan kepada Anda.

  2. Ikuti proses normal untuk melakukan fork project, dan siapkan cabang baru untuk dikerjakan. Setiap grup perubahan harus dilakukan di cabang terpisah untuk memastikan bahwa permintaan pull hanya menyertakan commit yang terkait dengan bug atau fitur tersebut.

  3. Setiap perubahan signifikan hampir selalu disertai dengan pengujian. Project ini sudah memiliki cakupan pengujian yang baik, jadi lihat beberapa pengujian yang ada jika Anda tidak yakin cara melakukannya.

  4. Pastikan pesan commit yang dibuat dengan baik untuk setiap perubahan. Hal ini memberikan konsistensi di seluruh project, dan memastikan bahwa pesan commit dapat diformat dengan benar oleh berbagai alat git.

  5. Terakhir, tekan commit ke fork, lalu kirimkan permintaan pull.