The comments seem to be duplicates of the code, while the code is already very readable by itself. The comments are redundant in this case and not necessary. Developers can easily read the code and understand what’s happening. Let’s simplify this example.
Kevin Van Ryckegem
I looked into that some years ago. These comments are not there because the programmer thinks his colleagues are stupid. Often programmers write pseudocode in comments before writing the real code, and then leave the comments in.
Your 'why' comments are great, but they really should be in the header comment to be 100% useful.