Teknik belge varsayım hatası, deneyimli yazarların bile düştüğü en yaygın tuzaklardan biri. Belgeyi yazan kişi konuya o kadar hakimdir ki okuyucunun hangi noktada takılabileceğini hayal edemez. Ve bu kör nokta, onlarca saatlik geliştirici zamanını boşa harcatır. Teknik belge varsayım hatası şu biçimlerde tezahür ediyor: "Ortam kurulumunu tamamladıktan sonra", hangi ortam? "Varsayılan ayarları kullanıyorsanız", hangi ayar varsayılan? "Standart yapılandırmayı izleyin", standart ne demek? Her bu ifadeler, okuyucunun deneyimini görmezden gelen birer boşluk. Bu sorun özellikle kütüphane ve framework belgelerinde belirgin. Geliştiriciler başlangıç rehberine bakıyor, ilk adımdan takılıyor. Neden? Çünkü belge yazarı, o kütüphanenin ekosistemini zaten biliyor ve hangi araçların kurulu olması gerektiğini, hangi ön koşulların mevcut olduğunu söylemiyor. Teknik belge varsayım hatasının test yöntemi net: Belgeyi, o konuyu bilmeyen birine okut. Eğer bir yerde duraksıyorsa, orada bir boşluk var demektir. Bu test bir kez yapılsa, pek çok belgenin ne kadar çok boşluk barındırdığı görülür. Çözüm için ön koşullar bölümünü her belgenin başına koy. Teknik terimleri ilk kullanımda açıkla. İstisna durumları önceden belirt. Ve belgeyi bir kullanıcı perspektifinden düzenli olarak gözden geçir. Teknik belge varsayım hatası, iyi niyetle yazılmış ama işe yaramaz belge üretiyor. Niyet yeterli değil, empati şart.