ANONYMOUS wrote:

The Style section of the rubric for the assessed lab says we need to use "comments to communicate intent and reason".

What sort of comments are required to obtain this mark, and do we need to include comments even if the code is self explanatory?

I tried to choose the wording "communicate intent and reason" carefully. It is not necessary to simply narrate what your code is doing, as the code already says that clearly. Your comments should explain why you have decided to do that.

Code that is "self-explanatory" typically only explains the steps it is performing, not the reasoning. Please make sure to explain your reasoning wherever a non-trivial decision has been made. The reader should not have to be solving a puzzle or guessing at your thought process as to why you wrote the code you did.