ศิลปะการขัดเกลาต้นฉบับ - วิธีเขียนเอกสารเชิงเทคนิคสำหรับนักพัฒนา

<p>- การขัดเกลาต้นฉบับ: การคิดทบทวนหลายครั้งระหว่างเขียนเพื่อแก้ไขและปรับแต่งข้อความ หรือหมายถึงกระบวนการดังกล่าว<br /> - เหตุผลที่การขัดเกลาต้นฉบับเป็นสิ่งจำเป็น<br /> - เคล็ดลับการขัดเกลาต้นฉบับ<br /> → ทำให้บทความของตัวเองดูแปลกตา: อ่านออกเสียง, อ่านอีกครั้งหลังเวลาผ่านไปสักพัก, พิมพ์ออกกระดาษแล้วอ่าน<br /> → การรีวิวโดยเพื่อนร่วมงาน <br /> → ใช้เช็กลิสต์ <br /> → เคล็ดลับการแก้ประโยคเพื่อให้อ่านง่ายขึ้น <br /> ① สรุปและแก้ไขให้เป็นประโยคสั้น<br /> ② ลบสำนวนที่ไม่จำเป็น<br /> ③ ปรับให้เป็นงานเขียนที่มีตรรกะมากขึ้น</p>

[budlebee]

<p>ทำให้นึกถึงหลักการเขียนของ Stephen King เลยครับ แม้จะเป็นงานนิยายจึงอาจมีจุดที่ต่างจาก technical writing อยู่บ้าง แต่ถ้าจะเขียนเท่าที่นึกออกก็ประมาณนี้<br /> <br /> - ใช้ประโยคสั้นและเรียบง่าย<br /> - ผมเขียนฉบับร่างแรกเสร็จแล้วจะเก็บมันไว้ในลิ้นชัก จากนั้นอีก 6 เดือนค่อยหยิบออกมาอ่านใหม่<br /> - ฉบับแก้ไขจะตัดออกจากฉบับร่างแรก 10%<br /> - ลองอ่านออกเสียงดู จะช่วยจับส่วนที่ประโยคฟังดูแปลก ๆ ได้<br /> - เขียนโดยกำหนดผู้อ่านเป้าหมายให้ชัดเจน สำหรับผมคือภรรยาของผม </p>

[xguru]

<p>ช่วงนี้ทีม Technical Writing ของ Kakao Enterprise เขียนบทความดีๆ ออกมาเยอะมากเลยนะ แนะนำให้ติดตามบล็อกไว้!</p>