Teknik yazar geliştirici iletişimi meselesini iş hayatıma girdiğimde hafife aldım. 'İkimiz de aynı ürün üzerine çalışıyoruz, anlaşırız' dedim. İlk altı ayda anlaşamadığımız o kadar çok şey oldu ki. Teknik yazar geliştirici iletişiminde ilk ve en büyük engel: zaman. Geliştiriciler toplantı istemez. Çoğu, bir Slack mesajına bile geç cevap verir. Bu onların kötü niyetinden değil, akış halindeyken kesilmek istemediklerinden kaynaklanıyor. Bunu anlamam aylar aldı. İkinci engel dil. 'Bu özellik nasıl çalışıyor?' diye sorduğumda bana teknik mimari anlatıyorlardı. Ben kullanıcı perspektifinden anlatım istiyordum. Soruyu değiştirdim: 'Bir kullanıcı bunu neden kullanır?' diye sordum. Cevaplar farklılaştı. Teknik yazar geliştirici iletişiminde işe yarayan birkaç yöntem keşfettim. Kısa async sorular her zaman kazanır; 'toplantı açayım mı?' yerine tek soruluk mesaj atın. Ekran görüntüsü ile soru sormak iletişimi hızlandırır. Geliştiriciyi review sürecine dahil etmek için asenkron yorum aracı kullanın; 'bir saatini al' demek yerine 'iki dakika bak' deyin. En çok öğrendiğim ise şu: geliştiriciler genellikle yardım etmek istiyor, sadece nasıl istendiği önemli. Saygılı, net ve kısa sorular mucize yaratıyor. Teknik yazar geliştirici iletişimi zorlu ama çözülür bir denklem. Formülü bulmak zaman alıyor, bulunca her şey değişiyor.