ฉันกำลังอ่านรหัสเก่าที่ฉันเขียน (ปีแรกในมหาวิทยาลัย) และสังเกตว่าฉันเคยเขียนชื่อความคิดเห็นก่อนหน้าส่วนต่าง ๆ ของรหัส สิ่งที่ชอบ (นี่คือจากเกม Monopoly):
/*Board initialization*/
...code...
/*Player initialization*/
...code...
/*Game logic starts here*/
/*Displaying current situation*/
...code...
/*Executing move*/
...code...
/*Handle special event*/
...code...
/*Commit changes, switch to next player*/
...code...
นี่อาจซ้ำซ้อนและไม่จำเป็นต้องใช้รหัสหากรหัสนั้นชัดเจนจริงๆ แต่เมื่อฉันสแกนผ่านไฟล์มันทำให้ฉันประหลาดใจอย่างมากฉันรู้สึกอย่างยิ่งว่าฉันรู้ว่าเกิดอะไรขึ้นแม้ว่าฉันจะดูรหัสจริงน้อยมาก ฉันสามารถเห็นสิ่งนี้ว่าเหมาะสมในบางสถานการณ์ดังนั้นฉันจึงสงสัยว่าคุณทำสิ่งนี้หรือไม่? คุณคิดว่าเป็นความคิดที่ดีหรือไม่? หรือมันมากเกินไป?