Kami dengan senang hati menyambut keinginan Anda untuk berkontribusi pada proyek ini. Segala bentuk kontribusi, baik berupa laporan bug, saran fitur, maupun pengajuan kode, akan kami apresiasi dan pertimbangkan demi pengembangan proyek yang lebih baik.
Penulisan panduan ini terbagi ke dalam dua jenis, yaitu panduan untuk kontributor internal dan kontributor eksternal.
Kontributor internal adalah pihak yang dengan sengaja diundang untuk menggarap proyek ini. Berikut adalah beberapa panduan yang perlu dipatuhi oleh para kontributor internal:
-
Upaya kontribusi ke branch utama
-
Kloning repositori ini ke komputer Anda
-
Ganti branch sesuai dengan nama Anda.
Saat ini sudah terdapat 4 branch dengan 3 role berbeda.
ui/dewita # berhubungan dengan tampilan antarmuka pengguna dan aset-aset yang akan dibutuhkan di dalam website db/afifah # berhubungan dengan skema basis data yang digunakan dev/farrel # implementasi ke website (frontend dan backend) dev/stevan # implementasi ke website (frontend)
Jika tidak ditemukan branch yang sesuai, maka Anda bisa membuat branch baru dengan menggunakan perintah berikut:
git checkout -b <nama-role>/<nama-anda>
-
Buat commit perubahan dengan pesan yang jelas (
git commit -m "menambahkan fitur notifikasi pada pengguna mahasiswa"
). -
Buat pull request ke branch utama (
main
). Buat penjelasan singkat mengenai perubahan yang telah dilakukan.
-
-
Mendapatkan pembaruan terkini dari branch utama
-
Lakukan upaya pull dengan tetap berada di branch anda.
⚠️ ANDA TIDAK PERLU MENGGANTI BRANCH KE MAIN! GANTI BRANCH MAIN JIKA BENAR-BENAR DIPERLUKAN SAJA!Ketikkan perintah berikut di terminal
git pull origin main
Maka akan secara otomatis pembaruan dari branch utama akan masuk ke branch lokal anda
-
Jika terjadi masalah saat proses penggabungan (merge), pastikan perubahan yang anda lakukan tidak mengganggu perubahan di branch utama. Jika anda bingung, lebih baik hubungi kepada manajer proyek untuk informasi lebih lanjut
-
Kontributor eksternal adalah pihak di luar kontributor awal yang menginisasi proyek ini. Berikut adalah beberapa panduan yang perlu dipatuhi oleh para kontributor eksternal:
- Fork repository ini ke akun Anda.
- Buat branch baru untuk perubahan Anda (
git checkout -b <nama-branch>
). - Lakukan perubahan sesuai kebutuhan dan pastikan kode Anda sudah sesuai standar proyek.
- Commit perubahan Anda dengan pesan yang jelas (
git commit -m "memperbaiki konfigurasi database mysql"
). - Buat pull request ke branch utama kami, disertai penjelasan singkat mengenai perubahan yang Anda lakukan.
Jika perubahan yang anda lakukan berdampak positif terhadap proyek, maka kami akan mempertimbangkan untuk proses merge ke branch main.