Trước hết, trong câu hỏi này, tôi muốn tránh xa cuộc bút chiến về việc nhận xét mã nguồn là tốt hay xấu. Tôi chỉ đang cố gắng để hiểu rõ hơn ý nghĩa của mọi người khi họ nói về những bình luận cho bạn biết TẠI SAO, CÁI GÌ hay CÁCH NÀO.
Chúng ta thường thấy các hướng dẫn như "Nhận xét sẽ cho bạn biết TẠI SAO; bản thân mã sẽ cho bạn biết CÁCH". Thật dễ dàng để đồng ý với tuyên bố ở mức độ trừu tượng. Tuy nhiên, mọi người thường bỏ điều này như một giáo điều, và rời khỏi phòng mà không cần giải thích thêm. Tôi đã thấy điều này được sử dụng ở rất nhiều nơi và bối cảnh khác nhau, có vẻ như mọi người có thể đồng ý với câu khẩu hiệu, nhưng dường như họ đang nói về những điều khác nhau hoàn toàn.
Vì vậy, trở lại câu hỏi: nếu bình luận nên cho bạn biết TẠI SAO, đây là lý do TẠI SAO chúng ta đang nói về? Đây có phải là lý do tại sao đoạn mã đó tồn tại ở nơi đầu tiên? Đây có phải là những gì mà đoạn mã nên làm? Tôi thực sự sẽ đánh giá cao nếu ai đó có thể đưa ra một lời giải thích rõ ràng, và sau đó thêm một số ví dụ tốt (ví dụ xấu không thực sự cần thiết, nhưng được tự do thêm chúng để tương phản).
Có rất nhiều câu hỏi về việc bình luận là tốt hay xấu, nhưng không ai trả lời câu hỏi cụ thể về những ví dụ tốt về những bình luận nói với bạn TẠI SAO.
There are many questions on whether comments are good or bad, but no one that addresses the specific question of what are good examples of comments that tell you WHY.
Nếu mọi người cung cấp một ví dụ hợp lệ, thì tất cả họ đều là câu trả lời đúng. Định dạng của trang web này là để tạo điều kiện cho quá trình hỏi đáp trong đó không phải tất cả các câu trả lời đều được tạo ra như nhau.