Heise'nin 'Continuous Architecture' köşesindeki bir yazı, kolayca reddedilen ama çürütülmesi zor bir sav ortaya atıyor: yapay zekâ kod ajanları, ekipleri yıllar önce güvenmeyi bıraktıkları dokümantasyonu temizlemeye zorluyor.
Mekanizma gizemli değil. Bir depoda çalışan ajan ne bulursa okur — README dosyaları, mimari karar kayıtları, API dokümanları, yorumlar, diyagramlar, işe alıştırma notları — ve hepsini bağlam sayar. Eski bir dokümanı okuyan kıdemli bir geliştirici ömür boyu edindiği şüpheyle yaklaşır: kullanımdan kalkmış istemci kütüphanesini fark eder, uç noktanın taşındığını hatırlar, bir iş arkadaşına sorar. Ajanın böyle bir örtük bilgisi yok. Getirir, inanır ve ona göre kod yazar.
Böylece tanıdık bir can sıkıntısı, doğruluk sorununa dönüşür. Bayat bir README eskiden yeni bir çalışana yarım gün kafa karışıklığına mal olurdu. Şimdi derlenen, testlerini geçen ve artık var olmayan bir API'ye karşı entegrasyon yayan bir pull request üretebiliyor. Eksik dokümantasyon da daha güvenli değil: ajanın hiçbir şey bulamadığı yerde akla yatkın bir şeyle boşluğu dolduruyor — ve gözden geçiren kişinin hızla geçtiği şey tam olarak 'akla yatkın' olandır.
Yazının işaret ettiği çareler gösterişsiz ve çoğunlukla ucuz. Dokümantasyonu depoda kodun yanında tutun ve kodla birlikte sürümleyin. Yanlış olanı bırakmak yerine silin; çünkü eksik doküman soru sordurur, yanlış doküman kendinden emin saçmalık üretir. Karar kayıtlarına durum ve tarih verin ki 'kabul edildi' bir şey ifade etsin. API referanslarını ve diyagramları elle bakım yerine kaynak koddan üretin. Dokümandaki komutları CI'a koyun; böylece bozuk bir örnek okuyucuyu yanıltmak yerine derlemeyi düşürsün. Ve bir sahip atayın; sahipsiz dokümantasyon varsayılan olarak çürür.
Dürüst çerçeve şu: dokümantasyon borcu yapay zekâdan onlarca yıl eski; her kurum zaten elinde çok fazla olduğunu ve düzeltmeye vakti olmadığını biliyor. Değişen şey, hata biçiminin maliyeti. Yanlış bir doküman eskiden insan zamanını harcatırdı — pahalı ama kendini düzelten bir maliyet, çünkü insanlar fark eder. Ajanın tükettiği yanlış bir doküman ise bitmiş görünen bir iş ürünü üretir; asıl tehlikeli arıza budur.
Not: Bu bir haber değil, tartışma yazısı. Yukarıdaki somut pratikler bize aittir; yazının kendine özgü iddiaları heise kaynağından doğrulanmalıdır.
