"ข้อความคอมมิตที่ถูกใช้งานจริงในโปรเจกต์นั้นเรียบง่ายอย่างยิ่ง ทั้งไวยากรณ์ก็อยู่ในระดับภาษาอังกฤษมัธยมต้น และแทบไม่ได้ใช้คำศัพท์ยาก ๆ เลย ท้ายที่สุดแล้ว การเขียนข้อความใน commit log ควรเข้าหาด้วยแพตเทิร์น ไม่ใช่งานเขียนเชิงประพันธ์ กล่าวคือ นำลักษณะของคอมมิตของตัวเองไปเทียบกับแพตเทิร์น แล้วเลือกคำออกมา แม้มองในฐานะผลลัพธ์ของการเขียนแล้วอาจดูเรียบง่ายจนเหมือนไม่เพียงพอ แต่สำหรับการทำให้อ่านง่ายและเข้าใจง่ายสำหรับหลาย ๆ คน ประโยคเรียบง่ายที่เป็นแบบแผนกลับดีกว่ามาก
ถึงอย่างนั้น การเขียนข้อความคอมมิตให้ง่ายก็ยังเป็นเรื่องยาก ประการแรก การแยกงานแล้วคอมมิตให้สามารถอธิบายได้ด้วยประโยคเดียวไม่ใช่เรื่องง่าย ประการที่สอง ต้องสร้างประโยคที่บุคคลที่สามซึ่งเพิ่งเห็นเป็นครั้งแรก ไม่ใช่ผู้เขียนเอง จะสามารถเข้าใจได้ หลังจากพิมพ์ commit -m แล้ว เมื่อหน้าต่างสำหรับกรอกข้อความปรากฏขึ้น ลองหลับตา สูดหายใจเข้าลึก ๆ แล้วทบทวนสิ่งที่ได้ทำไป จากนั้นลองเลือกคำที่ดีที่สุดเพียงคำเดียวดู"
ยังไม่มีความคิดเห็น