Terima kasih telah tertarik untuk berkontribusi ke alrc-termux! Kontribusi Anda sangat dihargai dan membantu proyek ini berkembang. Di bawah ini adalah panduan tentang cara Anda dapat berkontribusi.
-
Fork Repositori ini
- Kunjungi halaman repositori dan klik tombol Fork di kanan atas untuk membuat salinan repositori ke akun GitHub Anda.
-
Buat Branch untuk Perubahan Anda
- Di fork Anda, buat branch baru untuk setiap fitur atau perbaikan yang ingin Anda tambahkan.
- Berikan nama branch yang deskriptif, misalnya:
fix-bug-123
atauadd-new-feature
.
-
Lakukan Perubahan Anda
- Lakukan perubahan yang diperlukan pada kode atau dokumentasi.
- Pastikan untuk mengikuti gaya penulisan dan konvensi yang digunakan dalam proyek ini.
-
Uji Perubahan Anda
- Jalankan semua tes yang tersedia untuk memastikan tidak ada yang rusak karena perubahan Anda.
- Jika Anda menambahkan fitur baru, tambahkan juga tes baru untuk fitur tersebut.
-
Komit Perubahan Anda
- Tuliskan pesan komit yang jelas dan informatif tentang apa yang Anda ubah.
- Gunakan format yang jelas seperti
Add
,Fix
, atauUpdate
, misalnya:Add support for new command in alrc
.
-
Push Perubahan ke Repositori Anda
- Setelah perubahan Anda siap, push ke branch di fork Anda.
-
Buat Pull Request (PR)
- Kembali ke repositori utama dan klik tombol New Pull Request.
- Pilih branch yang Anda buat dan ajukan PR.
- Berikan deskripsi yang jelas tentang apa yang Anda lakukan dalam PR tersebut.
- Ikuti Konvensi Kode: Gunakan konvensi penamaan variabel, fungsi, dan file yang konsisten dengan kode yang ada.
- Komentar yang Jelas: Berikan komentar yang jelas untuk fungsi-fungsi kompleks atau logika yang mungkin tidak langsung dipahami.
- Dokumentasi: Jika Anda menambahkan fitur baru, perbarui dokumentasi yang sesuai untuk mencerminkan perubahan tersebut.
Jika Anda menemukan bug atau masalah dalam proyek ini, silakan ikuti langkah-langkah berikut untuk melaporkannya:
- Cek Masalah yang Ada: Pastikan bug Anda belum dilaporkan oleh orang lain di Issues.
- Buat Laporan Baru: Jika bug belum ada, buat issue baru dengan deskripsi yang jelas tentang bug tersebut.
- Jelaskan langkah-langkah untuk mereproduksi bug.
- Sertakan informasi tentang lingkungan yang Anda gunakan, seperti versi Termux dan versi alrc-termux.
Jika Anda memiliki ide untuk fitur baru atau perbaikan, Anda dapat mengusulkannya melalui Issues. Jelaskan fitur atau perbaikan yang Anda usulkan secara rinci, termasuk alasan mengapa Anda pikir itu bermanfaat.
Dengan berkontribusi ke proyek ini, Anda setuju bahwa kontribusi Anda akan dilisensikan di bawah lisensi GPLv3.0, yang sama dengan lisensi proyek ini. Silakan baca LICENSE untuk informasi lebih lanjut.
Jika Anda memiliki pertanyaan atau butuh bantuan, Anda dapat menghubungi pemilik proyek di [email protected]
-
Penggunaan Bebas: Pengguna dapat menggunakan perangkat lunak untuk tujuan apapun tanpa batasan.
-
Modifikasi: Pengguna berhak memodifikasi perangkat lunak. Mereka juga dapat mendistribusikan modifikasi tersebut, tetapi harus tetap di bawah GPLv3.0.
-
Distribusi: Pengguna dapat mendistribusikan perangkat lunak Anda, baik dalam bentuk aslinya maupun modifikasi, asalkan mereka tetap mematuhi persyaratan GPLv3.0.
-
Akses ke Kode Sumber: Setiap distribusi perangkat lunak, baik versi asli maupun modifikasi, harus menyertakan atau menyediakan akses ke kode sumber.
-
Kebebasan dari Pembatasan Tambahan: Pengguna tidak boleh dikenakan pembatasan tambahan yang tidak ada di GPLv3.0 ketika menggunakan atau mendistribusikan perangkat lunak.