Altı ay önce yazdığınız koda baktığınızda "bunu kim yazdı?" diye düşünüyorsanız kod yorumlama alışkanlığı eksikliğiniz var demektir. Ve o kodu yazan sizdiniz. Kod yorumlama önemi programlamaya yeni başlayanlar için fazla soyut bir kavram gibi görünür. "Kodu anlıyorum zaten, neden açıklayayım?" sorusu sıklıkla sorulur. Ama kod yorumları sizi ilerideki siz ya da ekibinizdeki başka biri için yazılır. İyi bir yorum ne sağlar? Bir fonksiyon ne yapıyor olabilir, bunu kod zaten gösteriyor. Ama o fonksiyonun neden o şekilde yazıldığını kod söylemez. Özel bir edge case'i ele almak için alışılmışın dışında bir yaklaşım seçtiyseniz, bunu bir satır yorumla açıklamak sonraki programcının (ya da kendi gelecekteki halinizin) saatlerce kafa yormasını önler. Yorum yazmanın pratik kuralları: **"Ne" değil "neden" açıklayın.** `x = x + 1 // x'e 1 ekle` gibi yorumlar gereksiz. Bunun yerine neden bu adımın atıldığını yazın. **Karmaşık mantığı açıklayın.** Uzun regex ifadeleri, matematiksel formüller ya da alışılmadık algoritmalar mutlaka kısa bir açıklama satırı hak eder. **TODO ve FIXME kullanın.** Sonradan dönmek istediğiniz noktalara `// TODO: bunu daha verimli hale getir` gibi notlar bırakmak, proje boyunca hangi borçları taşıdığınızı takip etmenizi kolaylaştırır. **Eskimiş yorumları temizleyin.** Yanlış yorum yoktan kötüdür. Kod değiştiğinde yorumun da güncellenmesi gerekir. Kod yorumlama önemi sadece ekip çalışmasıyla sınırlı değil. Kendi solo projelerinizde bile üç ay sonra baktığınızda yorumlar size zaman kazandırır. Kod yazmak bir iletişim biçimidir, yorumlar bu iletişimin insani yüzüdür.