- İşe alımı durdurma ya da işten çıkarma kararlarının, “yapay zekanın insan teknik dokümantasyon yazarlarının yerini alabileceği inancı” nedeniyle verilmesinin ciddi bir hata olduğu uyarısı yapılıyor
- Yapay zeka tarafından üretilen dokümantasyonun zekâya ya da empatiye sahip olmadığı, ürünün gerçeğini ve bağlamını taşımayan boş bir kabuktan ibaret olduğu belirtiliyor
- Teknik dokümantasyon yazarlarının kullanıcı empatisi, bilgi toplama ve net anlatım yoluyla ürünü anlaşılır kılan kilit kişiler olduğu vurgulanıyor
- Yapay zeka destekli araçlar ile politikaları birleştiren ‘artırılmış teknik dokümantasyon yazımı’ üretkenliği artıran gerçekçi bir alternatif olarak sunuluyor
- Yapay zeka gürültü üretir, insan ise sinyal üretir — teknik dokümantasyon yazarlarının geri çağrılması ve yeniden işe alınması isteniyor
Teknik dokümantasyon yazarlarının yerine yapay zekaya bel bağlamanın sorunu
- Yapay zeka nedeniyle teknik dokümantasyon yazarlarını (Technical Writer) işten çıkarma ya da işe almama kararı büyük bir hata
- Yalnızca yapay zekanın yazdığı dokümantasyona dayanmak, uzman denetimi ve bağlam anlayışından yoksun bir çıktı ortaya çıkarır
- Dokümantasyon yükünü geliştiricilere devretmek, dokümantasyonun özünü yanlış anlamak anlamına gelir
- Teknik dokümantasyon basit bir çıktı değil, ürünün gerçeğini (product truth) taşıyan temel bir bileşendir
- Yazılım tamamlanmış, kendiliğinden anlaşılır ya da basit değildir; bu yüzden dokümantasyon olmadan kullanılamaz
- Teknik dokümantasyon yazarları bilgi toplama, açık ifade ve kullanıcı merkezli anlatım yoluyla ürünle kullanıcı arasında köprü kurar
Yapay zeka tarafından üretilen dokümantasyonun sınırları
- Yapay zeka tarafından üretilen dokümantasyon zekâdan yoksundur ve vizyonu eksiktir
- Yüz milyonlarca token üzerinde eğitilmiş olsa bile dokümantasyon stratejisi oluşturma, yapılandırma ve yeniden kullanım tasarımı yapamaz
- İstisnai durumları, ince sınırları ve tamamlanmamışlığın gerilimini yakalayamadığı için içerik boş kalır
- Hukuki sorumluluk yapay zekada değil, insanda kalır
- Hatalı yönergeler zarar doğurursa sorumluluk yöneticilere ya da şirkete ait olur
- Yapay zeka modeli işten çıkarılamaz ya da mahkemeye verilemez; sorumluluktan kaçmak mümkün değildir
- Yapay zekanın dokümantasyon üretebilmesi için mevcut, yüksek kaliteli bağlama (context) ihtiyacı vardır
- RAG, Cursor kuralları, Claude Skills gibi araçların hepsi teknik dokümantasyon yazımının bir uzantısıdır
- Dokümantasyon yazarlarını işten çıkarırsanız, yapay zekanın öğrenebileceği temel veri de ortadan kalkar
Teknik dokümantasyon yazarları ile yapay zekanın işbirliği potansiyeli
- Yapay zeka araçları ve eğitim sağlanırsa teknik dokümantasyon yazarlarının üretkenliği büyük ölçüde artabilir
- Yapay zeka politikalarıyla kalite korunurken, yapay zekayla işbirliği yapan yeni nesil bir dokümantasyon ortamı kurulabilir
- Şimdiden bazı teknik dokümantasyon yazarlarının yapay zekayı kullanarak yazım, düzenleme ve yayımlamayı otomatikleştirdiği örnekler var
- AWS CEO’su Matt Garman da insanın yerini almaktan ziyade destekleyici yönde üretkenlik artışını kabul ediyor
- Şirketler, teknik dokümantasyon yazarlarıyla birlikte yapay zeka stratejisi kurmak ve denemeler yapmak için zaman ve kaynak sağlamalı
- Teknik dokümantasyon yazarları zaten sınırlı kaynaklarla verimliliği en üst düzeye çıkarma becerisine sahip
- Uygun araçlar ve fırsatlar verildiğinde yapay zekayı dokümantasyon kalitesini yükseltmek için kullanabilirler
Yeniden işe alım ve bakış açısında değişim çağrısı
- Yapay zekanın insan rolünü tamamen ikame ettiği yönündeki yanlış varsayım terk edilmeli
- Teknik dokümantasyon yazımı, yalnızca kelimeleri yan yana getirmek değil; uzman röportajları, ürün anlayışı ve bağlam yorumunu da içerir
- Teknik dokümantasyon yazarları lüks değil, zorunlu bir iş gücüdür; ürünü kullanılabilir hâle getiren çevirmenler gibi çalışırlar
- Onlar olmadan ürün ya kendini açıklayamaz ya da yanlış bilgi aktarır
- Metin, yapay zeka sonsuz gürültü üretir ama insan anlamlı sinyal üretir sonucuyla bitiyor
- İşten çıkarılmış Technical Writer’ların geri çağrılması ve birlikte çalışılması isteniyor
2 yorum
Mesele AI mı insan mı değil,
asıl belirleyici olanın "kullanıcı empatisi, bilgi toplama, net aktarım" yapabilmek olup olmadığı olduğunu düşünüyorum.
Hacker News yorumları
Ben profesyonel olarak dokümantasyon yazan biriyim
Ama aslında işim gözlemlemek, dinlemek ve anlamak
İyi yazmak için okurun kaygısını ve kafa karışıklığını derinlemesine anlamak gerekir
Yabancı bir toplu taşıma sistemini her deneyimlediğimde yerel ulaşım rehberini düzeltirim
Yazıyı, okurun bakış açısından kafa karışıklığını bizzat yaşayarak geliştiririm
İşimi çalıştıran motor empati
Yıllar içinde insanlarla kurduğum güven ilişkileri sayesinde bilgi toplamak için bir altyapı kurdum
AI yalnızca zaten kayda geçmiş olanla uğraşır, ama ben doğrudan dünyaya çıkıp soru sorarım
Göçmenlik ofisi deneyimlerini toplamak için bir araç yaptım ve yüzlerce avukatla uzmanı röportaj yaptım
AI veriye dayanır, ama ben verimi bizzat avlarım
AI'ın bu işi benim yerime yapabileceğine inanmak, bu mesleğe yönelik aşağılayıcı bir yanlış anlamadır
Toplu taşıma dokümantasyonu berbatlaşsa da gelir hemen düşmüyor
Ama teknik yazarı işten çıkarırsan bütçe anında azalıyor
Yazılımda da aynı durum var — giriş engelleri yüksek olduğu için “Bu kötüymüş, ben daha iyisini yaparım” demek zor
Kod, bilgisayarın okuduğu dokümantasyondur
Bilgisayarın sağduyusu yoktur, bu yüzden tüm kavrayış programcıya bağlıdır
LLM'in dilbilgisel olarak doğru cümleler üretmesi, iyi dokümantasyon yazdığı anlamına gelmez
Aynı şekilde, derlenen kod üretmesi de kullanıcının istediği programı yaptığı anlamına gelmez
Ben de aynı düşünceyi “teknolojinin ruha ihtiyacı vardır” ifadesiyle anlatıyorum
Teknik dokümantasyonun, UI'ın ve ürünün değer kazanması için içine insani bir duyarlılık sinmiş olmalı
AI'ın insanın yerini alma hırsı aşağılayıcı
Biz her şeyi kayda geçirmeyiz — ne kadar sağduyuluysa o kadar az kayda geçirilir, ama AI tam da bu veriye ihtiyaç duyar
Teknik yazarları işten çıkaran bir şirketin çalışanı değilim ama bizim şirkette de aynı şey oldu
Yazarlar AI'a dayanmaya başlayınca sonuçlar korkunçtu ve kendi başlarına neredeyse hiçbir şey yazamaz oldular
Piyasada iyi teknik yazar bulmak zor, portföyü iyi görünse bile pratikte çok kötü çıkan çok kişi var
Sonunda dokümantasyon işi geliştiricilere kalıyor — ama geliştiriciler bunu kariyerlerine yazmak istemiyor
Azıcık bile iyi olan bir yazarı işten çıkarmak, işi batırmanın yoludur
AI, README ya da config gibi örüntüsü düzenli verilerde güçlü ama ürün dokümantasyonu gibi özgün içerikte zayıf
AI'ın iyi yaptığı dokümanlar var — kimsenin okumadığı, sadece compliance için hazırlanan dokümanlar
Bu tür dokümanlar CPU gibi temel terimleri tanımlar ama asıl önemli alan terimleri eksiktir
Erişilemeyen belge referansları, kodla uyuşmayan UML, eski imzalar, birbirinden kopuk ekran görüntüleri gibi şeylerle doludur
Formatları da tutarsızdır; bu yüzden bu tür dokümanları depresif bir QA yöneticisi dışında kimse okumaz
Özellikle bol somut örnek verirseniz AI daha iyi yardımcı oluyor
En iyi teknik yazarlar yalnızca ürünü dokümante etmez
Gerçek bir kullanıcı gibi davranıp kullanılabilirlik sorunlarını bulurlar
Mühendislerle bire bir görüşmelerde gerekli bilgiyi çekip çıkarma becerisine sahiptirler
AI bu rolü iyi yerine getiremiyor
İçeride de ilk kez görülen bir içerik için ilk izlenim geri bildirimi çok önemlidir
Ama birçok organizasyon departmanlar arası geri bildirim kültürünü engelliyor
Sonuç olarak, pazarlama amaçlı teknik içerik çoğu zaman muğlak ve anlamsız oluyor
Çünkü birçok projede ya hiç dokümantasyon yok ya da çok kötü
Karmaşık iş akışlarını ilk fark eden kişi olur
Sıklıkla Python gibi dillere de hâkim olacak kadar teknik sezgileri vardır
AI teknik yazarların yerini alabilir ama iyi bir ikame değildir
En iyi dokümantasyona sahip şirketler yine de insan yazar çalıştıracaktır
Birçok kişi “herkes yazabilir” sanrısına kapılıyor ama gerçekte öyle değil
(İlgili yazı: Nobody Can Write)
Teknik yazarlar UX'e ve teste de katkı sunar, ayrıca API adlandırma kurallarındaki tutarsızlıkları da ilk onlar fark eder
AI yardımcı araç olarak işe yarar ama edit etmeden doğrudan yayımlamak tehlikelidir
İlgili tartışma için bu yoruma bakın
En iyi teknik yazarlar bir antropolog gibi ürün ekibi, mühendisler ve kullanıcılar arasında köprü kurar
Bu bakış açısı sayesinde ürünün kendisi de iyileşir
Dokümantasyon işi geliştiricilere yıkılıyor ve geriye sadece “AI ile yapın” talimatı kalıyor
Bunun gerçekten vaat edilen gelecek olup olmadığını sorguluyorum
insanlar arasındaki kültürel boşlukları sezme yetisine sahip değil
2026'da yazma ve iletişim becerilerimi daha da geliştirmek istiyorum
Bu tür beceriler kolay kolay ikame edilemez
Kişi bunları kendisi öğrenince düşünme biçimi değişiyor ve hayatın başka alanlarına da faydası oluyor
İnsanların beceri yükseltmesinin ortadan kalkması asıl kayıp
LLM'lerin tekdüze üslubu çok çabuk bayıyor
Uzun vadede bakınca hız kazanımı, beceri kaybını telafi etmeyebilir
İlk başta başlık kafamı karıştırdı
“AI kullanırken yakalanıp işten atılan yazarlara mektup” sandım
Metnin tamamı dil açısından muğlaktı, bu da ironik biçimde insan yazarlara olan güvenimi azalttı
Ben de İngiliz edebiyatı ve CS okudum, doktora öğrencilerine yazı yazmayı öğrettim ve
şimdi şirket dokümantasyonunu bizzat yönetiyorum
ikinci yorum (“AI ile değiştirilen yazarlara”) daha doğal geliyor
Sigorta şirketlerinden öğrenilecek şeyler var
Onlar AI'ı haklı talepleri reddetmek için gerekçe bulmakta kullanıyor
Mahkemede ise sorumluluktan “yazılım hatası” diyerek kaçıyorlar
Umarım bu tür mazeretler standart hâline gelmez
LLM'lerin bundan sonra da gelişmeye devam edeceği beklentisine sahip olmalı mıyız?
Birçok yazı mevcut sınırlamaları kalıcıymış gibi varsayıyor
Gelişme ihtimalini görmezden gelmek bana dar görüşlü geliyor
Beklenti düzeyi kişiden kişiye değişir