Konvensi Penamaan untuk Developer
Nama yang baik membuat kode self-documenting. Panduan ini mencakup praktik terbaik untuk penamaan di berbagai bahasa.
Nama Deskriptif
Gunakan nama yang mengungkapkan niat: getUserById lebih baik dari get atau fetch. Hindari singkatan yang ambigu: calc bisa menjadi calculate, calculator, atau calculation. Nama harus menjawab mengapa ada, apa yang dilakukan, bagaimana digunakan. Jika nama memerlukan komentar, pilih nama yang lebih baik. Lebih panjang dan jelas lebih baik dari pendek dan samar.
Konvensi Konsisten
Ikuti konvensi bahasa: camelCase di JavaScript, snake_case di Python. Gunakan PascalCase untuk class dan constructor di semua bahasa. SCREAMING_SNAKE_CASE untuk konstanta secara universal. Boolean harus dimulai dengan is/has/can untuk kejelasan (isValid, hasPermission). Konsistensi di codebase lebih penting daripada preferensi pribadi.
Konteks Penting
Dalam class User, getName() lebih baik dari getUserName()—konteks jelas. Untuk fungsi global, getUserName() lebih deskriptif. Hindari redundansi: user.getUserId() bisa hanya user.getId(). Gunakan nama yang lebih pendek untuk scope yang lebih kecil, yang lebih deskriptif untuk yang lebih besar. Variabel loop dapat berupa i, j, k jika loop sederhana. Untuk loop kompleks, gunakan nama deskriptif.
Coba Alat
Converter Huruf Besar/Kecil