Teknik yazarlar için yapay zekâ: belge taslağı ve inceleme
- Okuma süresi: 4 dk
- Kod bilgisi gerekmez
Yazılım teknik yazarı, ürünün nasıl çalıştığını kullanıcının anlayacağı dille anlatır. Yapay zekâ ilk taslakta ve tutarlılık kontrolünde yardımcı olur; adımların gerçekten çalıştığını ise ancak ürünü deneyen yazar bilir.
Aklınıza bir soru mu takıldı?
Bu derste neler öğreneceksiniz?
- Sürüm notu ve yardım sayfası için ilk taslağı yapay zekâyla hazırlamayı
- Taslaktaki her adımı ve kod örneğini nasıl sınayacağınızı
- Terim ve ton tutarlılığı için yapay zekâdan nasıl yararlanacağınızı
- Yayımlanmamış ürün bilgisini nasıl koruyacağınızı
Gerçek örnek: Microsoft Learn’ün ilkeleri
Microsoft, Microsoft Learn belgelerinde yapay zekâ kullanımına dair ilkelerini yayımlıyor. Sayfaya göre şirket, Learn’de yayımlanan bazı metin ve kod örneklerini Azure üzerinden eriştiği büyük dil modelleriyle üretiyor. Amaçlar arasında daha fazla programlama dilinde örnek, çözümlerde daha fazla derinlik ve yeni senaryoları daha hızlı kapsama var.
Süreç de anlatılmış. Yazar makaleyi planlıyor, bir kısmını yapay zekâyla ürettiriyor, çıktıyı gözden geçirip düzeltiyor ve kalan bölümleri kendisi yazıyor. Yazar tüm yapay zekâ içeriğini inceliyor. Ardından standart denetimler biçimi, terimleri ve kapsayıcı dili kontrol ediyor. Yapay zekâ ile üretilen her kod, yayımlanmadan önce yazar tarafından elle ya da otomatik testle deneniyor. Sayfa, yapay zekâ içeriğinin her zaman doğru olmadığını açıkça kabul ediyor.
Şeffaflık kuralı da var: yapay zekâ içeren her makalenin sonunda bunu belirten bir not bulunuyor.
Teknik yazarların kendi görüşü için 2023’te yapılan, 291 kişinin katıldığı gayriresmî bir anket var. Anketi yürüten yazar Tom Johnson analizinde katılımcıların özellikle donanım, tıp ve hukuk belgelerinde yapay zekânın kaliteli içerik üretebileceğine kuşkuyla baktığını yazıyor. Birçok katılımcı doğruluk ve eksiksizlik için hâlâ uzman bir insanın gerektiğini söylemiş. Anket 2023 tarihli ve gayriresmî; güncel durumun kanıtı olarak değil, mesleğin kaygılarını gösteren bir gösterge olarak okuyun.
Günlük işte üç somut kullanım
Birincisi sürüm notu. Değişiklik isteklerinin başlıklarını ve geliştiricinin kısa notlarını yapay zekâya verip kullanıcı diliyle bir sürüm notu taslağı istersiniz. Taslağı ürün yöneticisine ve ilgili geliştiriciye okutmadan yayımlamayın. Yapay zekâ kendisine anlatılmamış bir değişikliği bilemez; yani taslakta eksik madde de olabilir.
İkincisi yardım sayfası taslağı. Uzmandan aldığınız notlardan “şu ayarı nasıl açarım?” sayfasının iskeletini çıkarırsınız. Sonra siz ürünü açıp adımları tek tek uygularsınız. Menü adı ya da düğmenin yeri taslağın söylediğinden farklıysa düzeltirsiniz. Microsoft’un da yaptığı gibi, taslaktaki kod örneğini çalıştırmadan yayımlamayın.
Üçüncüsü tutarlılık. Elinizdeki terim listesini ve ton kurallarını verip bir sayfanın bu kurallara uyup uymadığını sorarsınız. “Kullanıcı, müşteri ve üye aynı kişi için karışık kullanılmış” gibi bir geri bildirim yararlıdır. Düzeltmeyi yine siz yaparsınız.
Sınırlar: bilgi sahibi sizsiniz
Yayımlanmamış özellikleri, iç sistem adlarını ve müşteri bilgilerini kurum dışı bir araca yazmayın. Gizlilik anlaşmanız bunu yasaklıyor olabilir. Müşteri verisi geçiyorsa Kişisel Verileri Koruma Kurumu’nun üretken yapay zekâ rehberine başvurun.
Bir de okurun bakış açısı var. Yapay zekâ akıcı yazar, ama akıcı metin doğru metin demek değildir. Okur yardım sayfasındaki yanlış bir adım yüzünden ayarını bozarsa, hata yapay zekâya değil yayımlayan kuruma yazılır. Bu yüzden yayın onayını insana bırakmak, hız kaybı değil güven yatırımıdır.
Güvenlik uyarıları, hukuki metinler ve sağlıkla ilgili ürün talimatları özel dikkat ister. Bu belgelerde yapay zekânın ürettiği her cümle ilgili uzmanın onayından geçmelidir. Kurumunuzun yapay zekâ kullanımını belgede belirtme kuralı varsa uygulayın; Microsoft örneği gibi bir not eklemek okurun güvenini korur.
Adım adım uygulama
- Uzman notlarını ve değişiklik başlıklarını toplayın; gizli bilgileri ayıklayın.
- Yapay zekâdan hedef okuru belirterek ilk taslağı isteyin.
- Taslaktaki her adımı ürünü açıp sırayla uygulayın.
- Kod örneklerini çalıştırın; menü ve düğme adlarını ekrandakiyle eşleştirin.
- Terim listesine göre tutarlılık kontrolü yaptırın ve düzeltmeleri kendiniz uygulayın.
- Uzmana ve ürün sahibine onaylatın; kurum kuralınıza göre yapay zekâ notunu ekleyin.
Kontrol listesi
- Her adım ürünle denendi mi?
- Kod örnekleri çalıştı mı?
- Menü ve düğme adları ekranla aynı mı?
- Yayımlanmamış bilgi araca gitmedi mi?
- Uzman onayı alındı mı?
Zayıf komut
Bu özelliğin yardım sayfasını yaz.
Güçlü komut
Rolünüz: yazılım teknik yazarı yardımcısı. Okur: ilk kez kullanan, teknik olmayan bir yönetici. Aşağıda uzmandan aldığım notlar var. Bunlardan “Bildirim ayarlarını değiştirme” başlıklı bir yardım sayfası taslağı yazın: iki cümlelik giriş, numaralı adımlar, bir uyarı ve en çok iki sorun giderme maddesi. Notlarda olmayan hiçbir menü adı ya da düğme adı uydurmayın; bilmediğiniz yeri [KONTROL ET] diye işaretleyin. Kısa cümle kullanın. Notlar: [buraya yapıştırın]
Yapay zekâ çıktısı (örnek)
Bildirim ayarlarını değiştirme. Bu sayfa, hangi olaylarda bildirim alacağınızı nasıl seçeceğinizi anlatır. 1) Ayarlar menüsünü açın. 2) Bildirimler bölümüne gidin [KONTROL ET: bölüm adı]. 3) İstemediğiniz bildirim türünü kapatın. Uyarı: Güvenlik bildirimlerini kapatmak önerilmez. Sorun giderme: Değişiklik kaydedilmiyorsa sayfayı yenileyin.
Sık yapılan hatalar
- Taslaktaki adımları ürünü açıp denemeden yayımlamak
- Yayımlanmamış özellik bilgisini kurum dışı bir araca yazmak
- Yapay zekânın yazdığı menü adını ekranla karşılaştırmamak
- Güvenlik uyarısını uzmana sormadan sadeleştirmek
İpucu
Komuta “bilmediğin yeri işaretle” kuralı koyun. İşaretlenmiş boşluk, uydurma bir menü adından çok daha ucuza düzeltilir.
Kendinizi deneyin
Microsoft Learn’ün sayfasına göre yapay zekâyla üretilen kod yayımlanmadan önce ne yapılır?
Yapay zekânın yazdığı yardım sayfasındaki bir menü adı ekranda yok. Ne yaparsınız?
Yayımlanmamış bir özelliğin notlarını kurum dışı araca yapıştırmadan önce ne düşünürsünüz?
Kaynaklar
- Microsoft Learn: Yapay zekâ ile üretilen içerik ilkelerimiz (İngilizce)
- I’d Rather Be Writing: Teknik yazarların yapay zekâ anketi analizi (2023) (İngilizce)
- KVKK: Üretken Yapay Zekâ ve Kişisel Verilerin Korunması Rehberi (15 Soruda) (Türkçe)
Son kontrol: 8 Kasım 2026
Kaynak: yzdersleri.com/ders/yazilim-teknik-yazarlari-icin-yapay-zeka-belge-taslagi-ve-inceleme/ · Yapay Zeka Dersleri
Dersi bitirdiniz mi?
İşaretlerseniz menüde ve ilerleme çubuğunda görünür. Bu bilgi yalnızca sizin tarayıcınızda saklanır.
Öğrenme yolunda sıradaki ders: Bulut operasyon uzmanları için yapay zekâ: olay araştırması
Bu ders işinize yaradı mı?
Anonim oydur; kişisel veri toplanmaz.
