3 ms·
I disagree with every single point. I don’t need help with reading comments. I need help with reading code. Highlighting comments distracts me from what I need
by wodenokoto 4y ago
I disagree with every single point.
I don’t need help with reading comments. I need help with reading code. Highlighting comments distracts me from what I need to focus on to read. The idea that comments are bad, is also one I disagree with.
WRT to git diff, I intuitively understood green is added. No one had to tell me. The two “better” diff examples would cause me to misunderstand or not understand intent.
- rockemsockem 4y agoThis +1000. By graying out comments the editor/site makes it much easier to separate these two separate-yet-interleaved streams of information. I don't want a big ugly call-to-action on every single comment. This guy seems like he should just customize his own syntax highlighting and diffing tools and be done with it.
- delusional 4y agoI highlight comments bright red in all editors, and it's really no different in terms of "filtering into separate streams". What it does significantly change is my initial approach to entering foreign code. Instead of immediately reading the code, my eye is drawn to the comments, often providing me with insightful commentary that then guides me in understanding the code. As a bonus, it has also made me more sensitive to outdated comments, which I views as a plus. Of course, comments also often contain the hidden assumptions or limitations of the algorithm that were too expensive to check. Often the comments actually do contain the bug you're looking for. I suggest you give it a shot. I didn't expect it to make as much of a difference as it ended up doing.