- Her geliştirici iyi kod yazar, ancak daha iyi bir mühendis olmak için yazma becerilerini geliştirmesi gerekir
Neden yazmalıyız?
- Yazmak, düşünceleri düzenlemenin bir yoludur
- Yazmak, bir şeyler öğrenmenin bir yoludur
- Yazmak, hataları fark etmenize yardımcı olur
Nasıl daha fazla yazabiliriz?
- Hatırlanması gereken şey: okumak bir alışkanlıktır, yazmak ise bir beceridir
- Bir beceriyi geliştirmek için daha çok yazmak gerekir
- Daha fazla yazmanın basit yollarından biri, tasarım incelemelerine farklı yaklaşmaktır
- Bundan nefret edip ödev gibi yapmak yerine, buna tutkuyla yaklaşın
- Her tasarım incelemesi yazdığınızda bir şeyi geliştirmeye çalışın
- Ana noktayı kaçırmadan daha kısa yazmayı deneyin; daha fazla kullanım senaryosunu kapsamak için daha uzun da yazmayı deneyin
- İş dışında da yazma becerinizi geliştirmek istiyorsanız bir blog başlatın
- Blog gözünüzü korkutuyorsa, Stackoverflow'da sorular yanıtlamayı deneyin. Kodu kopyalamayın; metin içeriği üretmeye odaklanın
- Son tavsiye: Copy & Paste yapmayın.
- Sorun şu ki herkes komutları GitHub/Google'dan kopyalıyor
- Verimsiz görüneceğinden endişe ediyorsanız, değerlendirmenin ölçütünün yazdığınız kod miktarı ya da görevleri ne kadar hızlı bitirdiğiniz olmadığını unutmayın
- Yazmaktan kaçış yok. İsteseniz de istemeseniz de 10x mühendis olmak için yazmanız gerekir
- "Dokümantasyon yazın, tasarım incelemeleri yazın, sunumlar hazırlayın. Yazmada ne kadar iyi olursanız, o kadar hızlı daha iyi bir mühendis olabilirsiniz."
1 yorum
Mühendisler için Google Technical Writing [İngilizce]
Technical Writing’in 4 temel ilkesi
Geliştiriciler için Technical Writing’in 10 emri
Technical Writing’i temiz ve düzgün tamamlamanın ilkeleri