Yazılımcının en sevdiği cümlelerden biridir: "Önce kodu yazalım, gerisi gelir." Gerisi gelir de nasıl bir gerisi... Bir saat dokümantasyon okumak yerine iki gün hata ayıklamayı yeğleyen bir meslek topluluğuyuz; sonra da "zaman yok" diye şikâyet ederiz. Bu köşede bugün tuhaf bir savunma yapacağız: okumak, kodlamanın en hızlı hâlidir.

Kısayolun Faturası

Dokümantasyon okumamanın bedeli sessizdir; çünkü fatura hep geç gelir. Kütüphanenin sürüm notlarını okumadan güncelleyen ekip, kullanımdan kaldırılan fonksiyonun hatasını üretimde görür. Kurumsal projede API sözleşmesini atlayıp kodu örneklerden kopyalayan geliştirici, kota limitinin davranışını üç ay sonra öğrenir. Bu kısayol, bize her zaman en pahalı yolu satın aldırır: gece saat birde bozulan yayını, yeniden yazılan modülü, kafası karışan kullanıcıyı. Okumak yavaştır; ama okumamak yavaşlığın taksitli hâlidir ve taksitleri asla erteleyemezsiniz. Dahası, okumayan geliştiricinin soruları da kalitesizleşir; yanlış varsayım üzerine kurulan doğru görünen sorular, ekip toplantılarını da zehir eder. Varsayımın yerini doğrulama alır ancak.

Kod yazmadan önce on dakika okuyan geliştirici, kod yazdıktan sonra iki gün okumak zorunda kalmaz. Dokümantasyon, başkalarının hatalarından bedava ders çıkarma sanatıdır.

Okuma Alışkanlığının Anatomisi

Okuma bir zihniyet işidir, göz egzersizi değil. Önce soruyu doğru koyun: "Bunu nasıl kullanırım" değil, "bu benim senaryomda nasıl davranır". Sürüm notlarını gazete gibi okuyun: manşetler sürüm başlıkları, haberler kırılma uyarılarıdır. API dokümanında örnek kodu kopyalamadan önce, altındaki açıklamayı okumak, kodun neyi yapmadığını da öğretir. Hata mesajlarını dikkatle okumak başlı başına bir sanattır; çoğu hata, çözümünü cümlesinde saklar. Son olarak kendi ekibinizin dokümantasyonuna da aynı saygıyı gösterin: tasarımları, mimari karar kayıtlarını, o "eski belgeyi" okuyun. Bir belge kimsenin okumadığı için mi geçersizdir, yoksa kimsenin okumadığı için mi tarihe karışmıştır? Okuyan ekip belge ister, belge okuyan ekip disiplin kazanır; döngü buradan beslenir.

Okuma alışkanlığı, ekip ölçeğinde de bir savunma hattıdır. Ortada belge varsa yeni gelen "neden böyle yazılmış" sorusunu arşivden bulur; belge yoksa aynı soruyu en meşgul kişinin kapısına taşır. Okumayan ekipte bilgi tek kişide toplanır, okuyan ekipte ise belgeye dağılır. Hangisinin sürdürülebilir olduğu açık: bilgiyi insana değil, yazıya bağlayan ekip, kişilerin izninde çalışmaz.

Okuyan Ekip

Okuma bireysel erdem olarak başlar ama ekip kültürü olarak değer kazanır. Kod incelemesinde "buradaki varsayımı nereden çıkardın" sorusu, okumayanın mağdur olduğunu değil, okuyanın korunmak istendiğini gösterir. Ekip dokümanı yazmak, okuyacağını bilmekten korkmamaktır. Okumadan kodlamak, haritanıza bakmadan yol almak gibi: bazen hedefe ulaşırsınız ama en kısa yolu hep bir başkası bilir. Zamanımızın en pahalı kısayolu budur; her tuşeye bastığınızda biraz daha pahalıya satın aldığınız bilgelik eksikliği. Okuyun; kısayolu asıl hız, gerçek yolu bulur.