Redaksiyonun Sanatı - Geliştiriciler için Teknik Doküman Yazma Yöntemi
(tech.kakaoenterprise.com)-
Redaksiyon (推敲): Yazı yazarken metni defalarca düşünüp düzeltmek ve cilalamak. Ya da bu işlem
-
Redaksiyonun gerekli olmasının nedenleri
-
Redaksiyon ipuçları
→ Yazınıza yabancı gözle bakmak: sesli okumak, bir süre sonra tekrar okumak, kağıda çıktı alıp okumak
→ Akran değerlendirmesi
→ Kontrol listesi kullanmak
→ Okunabilirliği artıran cümle düzenleme ipuçları
① Kısa cümlelerle düzenleyip yeniden yazmak
② Gereksiz ifadeleri silmek
③ Metni mantıklı bir yapıya dönüştürmek
2 yorum
Stephen King’in yazma ilkeleri aklıma geliyor. Kurgu olduğu için teknik yazımdan farklı yanları olabilir ama aklıma geldiği kadarıyla yazarsam
Kısa ve basit cümleler kullanır.
Ben ilk taslağı yazdıktan sonra onu çekmeceye koyar, 6 ay sonra çıkarıp yeniden okurum.
Düzeltilmiş sürüm, ilk taslaktan %10 çıkarır.
Yazıyı sesli okumak, cümlelerdeki tuhaf kısımları yakalamayı sağlar.
Yazıyı okuyacak hedef kitleyi somut olarak belirleyip öyle yazarım. Benim durumumda bu kişi eşim.
Bu aralar Kakao Enterprise teknik yazım ekibindekiler gerçekten çok iyi yazılar yazıyor. Bloga abone olmanızı tavsiye ederim!