6 ms·
Comments are secondary to code. Not that they're less important, but they're usually read when the code isn't obvious. I read in the following order: 1. Top-l
by SebastianKra 4y ago
Comments are secondary to code. Not that they're less important, but they're usually read when the code isn't obvious.
I read in the following order:
1. Top-level comments or README.md to get an overview. I don't care about the color.
2. The structure of the code - either looking for specific names, through source-code navigation, access of a specific variable, .... Here, non-greyed comments make scanning the file more difficult.
3. Comments that describe what can't be inferred from the code. Symbol names can be seen as headlines for comments - again, secondary to the headline.