Kod bir kez yazılır ama defalarca okunur. Bu yüzden okunabilirlik, zekice ama anlaşılmaz çözümlerden her zaman daha değerlidir. İşte yıllar içinde işime yarayan birkaç ilke.
1. İsimler niyeti anlatsın
Bir değişkenin adı, ne işe yaradığını yorum satırına gerek kalmadan söylemeli.
// Kötü
const d = 86400;
// İyi
const SANIYE_GUNDE = 86400;
2. Fonksiyonlar tek bir iş yapsın
Bir fonksiyonu tarif ederken "ve" demek zorunda kalıyorsan, muhtemelen onu bölmelisin. Küçük fonksiyonlar test etmesi ve yeniden kullanması daha kolaydır.
3. Yorumdan çok kodu düzelt
Bir kod parçasını açıklamak için uzun bir yoruma ihtiyaç duyuyorsan, önce kodu daha anlaşılır hale getirmeyi dene. En iyi yorum, gerek bırakmayan koddur.
4. Erken soyutlamadan kaçın
"İleride lazım olur" diye kurulan karmaşık yapılar çoğu zaman lazım olmaz. Basit başla, gerçek ihtiyaç ortaya çıkınca soyutla.
Bunlar kesin kurallar değil, birer rehber. En önemlisi: kodunu altı ay sonra okuyacak kişiye (muhtemelen yine sensin) iyi davran.