Güncel olmayan dokümantasyon, pek çok ekibin hafife aldığı ama ciddi hasara yol açan bir sorun. Yokluğu insanları araştırmaya yönlendirir; varlığı ise yanlış yönlendirir. İkincisi çok daha tehlikeli. Şöyle düşün: Bir geliştirici, belgelenmiş bir API'yi kullanmak istiyor. Belge üç yıl önce yazılmış ama güncellenmemiş. Geliştirici belgeye göre ilerliyor, production'da beklenmedik bir hatayla karşılaşıyor. Saatlerce hata ayıklandıktan sonra fark ediliyor: Belge yanlış. Asıl kayıp, hata değil; o harcanan zaman ve güven erozyonu. Güncel olmayan dokümantasyon özellikle tehlikeli olduğunda: Güvenlik prosedürleri için. Eski bir güvenlik kılavuzu, artık geçersiz bir yöntemi doğru olarak sunarsa, bu bir güvenlik açığı yaratabilir. Kritik altyapı süreçleri için. Operasyonel bir belge eski bir prosedürü anlatıyorsa, acil müdahale sırasında yanlış adım atılabilir. Bir diğer zarar: Güven yitimi. Ekipler bir kez güncel olmayan dokümantasyonla yanıyorsa, bir daha o belgelere bakmıyor. Yazılı bilgiye güven kayboluyor. Herkes sözlü aktarıma, Slack mesajlarına ve trial-error'a dönüyor. Bu da bilginin resmi kanaldan çıkıp kaybolmasına neden oluyor. Çözüm: Her belgeye son güncelleme tarihi ve sorumlusu ekle. Yazılım değişikliklerine doküman güncelleme eşliği koşul olarak belirle. Belirli aralıklarla otomatik uyarı sistemi kur. 6 aydan eski belgeler için review döngüsü başlat. Güncel olmayan dokümantasyon tutmak, yanlış harita vermeyle eş değer.