Bu yazı Robert Cecil Martin’in Clean Code kitabından alınan notları içermektedir.
- Bir değişkenin, methodun ya da sınıfın ismi sana onun neden var olduğunu, ne yaptığını ve nasıl kullanıldığını bildirmelidir. Değişken tanımının yanına ayrıca yorum satırı ile açıklama yapmana gerek kalmamalı. İsim, sana kullanım amacını söylemeli.
- Method oluşturmanın ilk kuralı, method kısa olmalı.
- Methodlar sadece bir iş yapmalı ve o işi iyi yapmalı.
- İsmi uzun tutmaktan çekinme. Uzun ve açıklayıcı bir isimlendirme, kısa ve gizemli bir isimden daha iyidir. Uzun bir isim uzun bir yorum satırından iyidir.
- Methodlarda mümkün oldukça parametre kullanma. Tek parametreli methodlar okunabilirdir. İki parametreli methodları mümkün oldukça kullanma. Üç ya da daha çok parametreli methodlar kullanmaktan kaçın. Parametre sayısı arttıysa bunları bir sınıf içine alıp, parametre olarak bu sınıftan oluşturulan bir nesneyi göndermeyi dene.