เหตุใดวิศวกรจึงควรให้ความสำคัญกับการเขียน

• นักพัฒนาทุกคนเขียนโค้ดได้ดี แต่หากต้องการเป็นวิศวกรที่ดียิ่งขึ้น ก็จำเป็นต้องพัฒนาทักษะการเขียนด้วย

ทำไมต้องเขียน?

• การเขียนคือวิธีจัดระเบียบความคิด
• การเขียนคือวิธีเรียนรู้บางสิ่ง
• การเขียนช่วยให้ค้นพบข้อผิดพลาดได้

จะเขียนให้มากขึ้นได้อย่างไร?

• สิ่งที่ต้องจำไว้: การอ่านคือความเคยชิน ส่วนการเขียนคือทักษะ
• หากอยากเชี่ยวชาญทักษะนี้ ต้องเขียนให้มากขึ้น
• หนึ่งในวิธีง่าย ๆ ที่จะเขียนให้มากขึ้นคือการเปลี่ยนวิธีเข้าหา design review
  • แทนที่จะเกลียดมันและมองว่าเป็นการบ้าน ให้ลองทำด้วยความกระตือรือร้น
  • ทุกครั้งที่เขียน design review ให้ลองพัฒนาอะไรบางอย่าง
  • ลองเขียนให้สั้นลงโดยไม่พลาดประเด็นสำคัญ และลองเขียนให้ยาวขึ้นเพื่อครอบคลุม use case ให้มากขึ้น
• หากอยากพัฒนาการเขียนนอกเวลางาน ลองเริ่มเขียนบล็อก
• ถ้ารู้สึกว่าบล็อกกดดันเกินไป ลองตอบคำถามบน Stackoverflow โดยอย่าคัดลอกโค้ด แต่ให้เน้นการให้เนื้อหาแบบข้อความ
• คำแนะนำสุดท้ายคือ อย่า Copy & Paste
  • ปัญหาคือทุกคนเอาแต่คัดลอกคำสั่งจาก GitHub/Google
  • หากกังวลว่าจะดูไม่ productive ให้จำไว้ว่าตัวชี้วัดไม่ได้อยู่ที่ปริมาณโค้ดที่เขียนหรือความเร็วในการทำงานเสร็จ
• การเขียนเป็นสิ่งที่หลีกเลี่ยงไม่ได้ ไม่ว่าจะชอบหรือไม่ก็ตาม หากอยากเป็นวิศวกรระดับ 10x ก็ต้องเขียน
• "จงเขียนเอกสาร เขียน design review และทำ presentation ยิ่งคุณเขียนเก่งขึ้นเท่าไร คุณก็จะยิ่งกลายเป็นวิศวกรที่ดีขึ้นได้เร็วขึ้นเท่านั้น"

[xguru]

Google Technical Writing สำหรับวิศวกร [อังกฤษ]
หลักการ 4 ข้อของ Technical Writing
บัญญัติ 10 ประการของ Technical Writing สำหรับนักพัฒนา
หลักการทำ Technical Writing ให้เรียบร้อยสมบูรณ์