-
Yazmak mühendisin temel yetkinliğidir
- Teknik yazı, commit mesajlarından dokümantasyona kadar her seviyedeki mühendis için vazgeçilmezdir.
- İyi yazmakla yazamamak arasındaki fark, iş verimliliği ve organizasyon içi iletişim üzerinde büyük etki yaratır.
-
Mümkün olduğunca yalın ve kısa yazın
- Okurlar bir yazıya fazla zaman ayırmaz.
- Bir fikri tek cümleyle aktarabiliyorsanız, öyle yapın.
- Bazı ayrıntıları bilerek atlamak aslında bir avantaj olabilir.
- Önemli noktaları yazının başına, ilk cümleye ya da başlığa yerleştirin.
-
Beklentileri gerçekçi belirleyin
- İnsanların teknik bir metni dikkatle okuyup tamamen anlayacağını varsaymayın.
- Mühendislik organizasyonlarında kafa karışıklığı ve anlama farkları normaldir; yazıyla herkesi aynı seviyeye getiremezsiniz.
- Beklentileri düşürmek, paradoksal biçimde daha etkili iletişim sağlar.
-
Yazının amacı, net çekirdeği aktarmaktır
- “Ayar eklemek karmaşıktır” gibi son derece basit bir noktayı geniş bir ekibe iletmek en öncelikli hedeftir.
- Teknik olarak eksiksiz bir anlayış yaratmaktan çok, asgari bağlam sağlayarak güven vermek daha önemlidir.
-
Gerçekte beklenebilecek etki
- Yazının alıcıları genellikle yazardan daha az arka plan bilgisine sahiptir.
- Geniş bir kitleye basit mesajlar, çok küçük bir gruba ise karmaşık içerikler net biçimde aktarılabilir.
- Yalnızca kritik noktaları işaret etmek bile büyük organizasyonlarda ciddi fark yaratır.
-
Açık düşünce, açık yazı üretir
- Yeterince anlaşılmamış bir konuyu sıkıştırmak zordur.
- Belirsizliği kabul edin ve net biçimde açıklayabildiğiniz kısımlara odaklanın.
-
Hatalar ve öneriler
- Çok fazla ayrıntı aktarma takıntısına kapılmayın.
- Vermek istediğiniz mesajı önce tek cümleye, sonra tek paragrafa, sonra tek sayfaya indirerek özünü en başta verin.
- Teknik arka planı neredeyse hiç olmayan kişilere bile büyük resmi aktarmak başlı başına değerlidir.
2 yorum
Anlaşılır kılmak için ek açıklamanın nasıl yerleştirilmesi gerektiği en çok kafa yorulan kısım oluyor
Karar verici kişi alana yabancıysa ya da...
Teknik belgelerle sınırlı değil, çoğu belge için de geçerli bir durum.