3 ms·
You can see my reply to the parent comment. I always sit down and talk with the students, but for us to talk about the code, we need to be able to read the code
by hvidgaard 10y ago
You can see my reply to the parent comment. I always sit down and talk with the students, but for us to talk about the code, we need to be able to read the code. Unneeded comments make it significantly harder to read code.
First time we talk about why I don't want "the what" comments, only "the why" comments. If they still do it in the next handin it's a fail unless they've explicitly provided me with a reasonable reason to do it.
- tamana 10y agoIn science, there is no such thing as why, there are only deeper levels of what. And those levels are subjective and relative to personal experience. Your comment merits a failing mark, downvotes, because you made the same subjectively wrong statement twice.
- hvidgaard 10y agoProgramming is not a science. "Pad to multiple of 256 otherwise libX will fail" is exactly what a comment is for, and it is the "why", no the "what" - the what is already readable in the code.