Tôi đã duyệt một số mã cũ mà tôi đã viết (năm đầu tiên ở trường đại học) và nhận thấy rằng tôi đã từng viết tiêu đề bình luận trước các phần khác nhau của mã. Những thứ như (đây là từ một trò chơi 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...
Điều này có thể là dư thừa và không cần thiết nếu mã thực sự rất rõ ràng, nhưng khi tôi quét qua tệp, nó làm tôi ngạc nhiên đến mức tôi cảm thấy như thế nào khi biết những gì đang diễn ra mặc dù tôi hầu như không nhìn vào mã thực tế. Tôi chắc chắn có thể thấy điều này là phù hợp trong một số trường hợp nhất định, vì vậy tôi tự hỏi - bạn có làm điều này không? Bạn có nghĩ rằng đó là một ý tưởng tốt? Hay là quá nhiều?