Terima kasih atas minat Anda untuk berkontribusi pada Codewhale! Dokumen ini memberikan panduan dan instruksi untuk berkontribusi.
- Rust 1.88 atau lebih baru (edisi 2024)
- Pengelola paket Cargo
- Git
-
Fork dan klon repositori:
git clone https://github.com/USERNAME_ANDA/CodeWhale.git cd CodeWhale -
Kompilasi proyek:
cargo build
-
Jalankan pengujian (tests):
cargo test --workspace --all-features -
Jalankan dalam mode pengembangan:
cargo run --bin codewhale
- Jalankan
cargo fmtsebelum melakukan commit untuk memastikan format kode konsisten. - Jalankan
cargo clippydan atasi seluruh peringatan. - Ikuti konvensi penamaan Rust (
snake_caseuntuk fungsi/variabel,CamelCaseuntuk tipe data/struct). - Tambahkan komentar dokumentasi untuk API publik.
- Tulis pengujian untuk fungsionalitas baru.
- Pastikan seluruh pengujian yang ada lulus:
cargo test --workspace --all-features. - Tempatkan unit test di samping kode yang diuji (
#[cfg(test)]), serta tambahkan pengujian integrasi di bawah direktoritests/pada crate yang bersangkutan.
- Buat branch baru dari
mainuntuk fitur atau perbaikan Anda. - Pastikan
cargo fmt,cargo clippy, dan pengujian lulus sebelum mengajukan PR. - Tulis judul dan deskripsi PR yang jelas yang menjelaskan tujuan perubahan.
- Setiap kontributor akan mendapatkan kredit dalam changelog dan
docs/CONTRIBUTORS.md.