Anda menemukan bug atau punya ide untuk fitur baru yang keren? Menyumbang kode adalah cara terbaik untuk memberikan sesuatu kembali kepada komunitas open source. Sebelum Anda menggali lebih dalam tentang kode ini, ada beberapa pedoman yang harus diikuti oleh para kontributor sehingga kami dapat memiliki kesempatan untuk terus mengetahui hal-hal terbaru.
Pastikan Anda memiliki akun JIRA.
Pastikan Anda memiliki akun GitHub.
Jika Anda berencana mengimplementasikan fitur baru, sebaiknya diskusikan perubahan Anda di daftar pengembang terlebih dahulu. Dengan cara ini Anda dapat memastikan bahwa Anda tidak membuang-buang waktu untuk sesuatu yang tidak termasuk dalam cakupan Apache Maven.
Kirimkan tiket untuk masalah Anda, dengan asumsi tiket belum ada.
Jelaskan masalahnya dengan jelas, termasuk langkah-langkah untuk mereproduksi jika masalahnya adalah bug.
Pastikan Anda mengisi versi paling awal yang Anda tahu bermasalah.
Cabangkan repositori di GitHub.
Kami menerima Permintaan Tarik melalui GitHub. Milis pengembang adalah saluran komunikasi utama bagi kontributor.
Ada beberapa pedoman yang akan membuat penerapan PR lebih mudah bagi kita:
Buat cabang topik dari mana Anda ingin mendasarkan pekerjaan Anda (biasanya ini adalah cabang master). Dorong perubahan Anda ke cabang topik di cabang repositori Anda.
Buat komitmen unit logis.
Hormati gaya kode asli: dengan menggunakan gaya kode yang sama, tambalan hanya akan menyoroti perbedaan sebenarnya, tidak terganggu oleh masalah pemformatan apa pun:
Hanya gunakan spasi untuk lekukan.
Buat perbedaan minimal - nonaktifkan tindakan penyimpanan seperti memformat ulang kode sumber atau mengatur impor. Jika Anda merasa kode sumber harus diformat ulang, buatlah PR terpisah untuk perubahan ini.
Periksa spasi yang tidak diperlukan dengan git diff --check
sebelum melakukan.
Pastikan pesan komit Anda dalam format yang benar. Pesan komit Anda harus berisi kunci masalah JIRA.
[MSHARED-XXX] - Subject of the JIRA Ticket Optional supplemental description.
Pastikan Anda telah menambahkan tes yang diperlukan (JUnit/IT) untuk perubahan Anda.
Jalankan semua tes dengan mvn -Prun-its verify
untuk memastikan tidak ada lagi yang rusak secara tidak sengaja.
Kirimkan permintaan tarik ke repositori di organisasi Apache.
Perbarui tiket JIRA Anda dan sertakan tautan ke permintaan penarikan di tiket.
Jika Anda berencana untuk berkontribusi secara rutin, harap pertimbangkan untuk mengajukan perjanjian lisensi kontributor.
Untuk perubahan yang bersifat sepele pada komentar dan dokumentasi, tidak selalu perlu membuat tiket baru di JIRA. Dalam hal ini, adalah tepat untuk memulai baris pertama dari sebuah commit dengan '(doc)' dan bukan nomor tiket.
Berkontribusi pada tambalan
Halaman proyek Komponen Bersama Apache Maven
Perjanjian Lisensi Kontributor
Dokumentasi GitHub umum
Dokumentasi permintaan tarik GitHub
Akun Twitter Apache Maven
Saluran #Maven IRC di freenode.org