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.

CEO at Schinchoku and software architect at Delphino Consultancy B.V. โ€” writing about software, and about the Shinchoku startup.