5 ms·
A code comment is not like an intro paragraph. Comments are second class compared to code; see any code base. Of course they don't actually do anything except
by hashkb 9y ago
A code comment is not like an intro paragraph. Comments are second class compared to code; see any code base. Of course they don't actually do anything except confuse humans, partially because they have no defined syntax or grammar, and partially because most programmers fail to maintain them as they change code.
- skybrian 9y agoEven incorrect comments are enlightening rather than confusing if you read them with the right mindset. From the code you can tell what the program actually does. From a comment you can get some idea about what the authors intended, at least at one time in the code's history.