Clean Code'da Comment'ler: Ne Zaman Yazılır, Ne Zaman Koda Dönüştürülür?
Kodun anlatabildiğini koda (isim, const, enum, method), anlatamadığını (neden, uyarı, dış bağlam, public API contract'ı) comment'e yaz: legacy OrderService'teki comment'lerin çoğu kodu tekrar ediyor, ikisi yalan söylüyor, changelog ve commented-out kodun yeri ise Git. Yazı XML doc comment'lerin CS1572/CS1573/CS1574/CS1591 ile nasıl doğrulandığını ve Ousterhout'un interface comment savunusunu gerçek çıktılarla anlatıyor.
7 Kas 2026
·
11 dk
·
4
