Hacker News Reader

Comment by msluyter | Hacker News Reader

I think these are all quite nice, however... am I the only person out there who likes comments to show up in a nice bright color (my preference, usually a bright terminal green). The faded comment look that most of these share is really hard for me to read.

View on HN

I prefer faded comments, because some of my code is quite heavily commented. The code itself is what I always read, and I want it to jump out at me. The comments are background info, observations, sometimes wordy descriptions of why things are the way they are, and so on. If I've been away from the code for a while, I'll read the comments to help reestablish the context, refresh my memory of failed experiments, of shortcuts, optimizations, and so on. Most of the time, I don't need to read these comments, so having them faded into the background works for me in every way except for the briefer, more urgent type of comment that SHOULD jump out.

One thing I would like to have is an editor that responded to tags within comments (so it wouldn't be a part of the programming lang syntax, but just a convention used by the programmer) which would apply different colors to different types of comments. I would then use a faded color for wordy background info or comments needed by anyone proposing to change the code but not needed for reading the code, brighter colors for brief comments on the intent of a chunk of code (making the code easier to skim) and maybe a very bright color for WARNING, or FIXME, or STUB-ONLY, or TODO, etc.

I kinda disagree; if your comments, observations etc don't JUMP OUT AT YOU READ THIS THIS IS IMPORTANT!1one, they're not important, apparently. This also goes for other people's code, really. There is often a difference between code and comments, which causes people to read the code instead of the comments. However, one cause is that comments don't draw the attention because they're often in a dimmed, 'this is not important' color scheme - the other is that there's too much comments that don't add value to the code.

I found this thread fascinating. It seems the more heavily people comment, the less they care about reading comments all the time: http://akkartik.name/blog/2012-11-24-18-10-36-soc.

It's almost like there's a law of conservation at work. The law of conservation of human attention. Comments can be used either as background hum or as salient landmarks.

> context, failed experiments, shortcuts, optimizations, and so on.

I think commit messages are the appropriate place for this stuff; I use `git annotate` etc. to find the information when I need it. I often have a 50-line commit message accompanying a one-line code change -- a ratio that would obviously make the code unreadable if all the comments were in-line with the code itself.

For me, hard to read is the point. Comments are something I want to be able to focus on and consume, but disappear if I'm not focussed on them.

That's a great point. I would love some sort of effect where if I've clicked on the comment block it is a lighter colour, otherwise it goes back to the default colour.

You could select it and get a good highlighted color.

I was gonna make a similar comment. All the themes I see are geared to be anti comment because of the lack of distinction in colors.

Right now I use the Tomorrow Night theme which seems to be okay but I would prefer to have a good light color scheme (the longest I ever used one was Espresso Soda theme).

Me too, they just look like empty space to me. I cycle between three, really like Tomorrow-night-blue https://dl.dropbox.com/u/19746944/themes.png

Love love love the Tomorrow Night theme with comments. Though I would much rather have brighter comments.

That's an easy fix. Also, this plugin https://github.com/Monnoroch/ColorHighlighter will help you with the colors.

Yeah, even my minimalist theme keeps comments salient: http://i.imgur.com/4uYrH.png.

Reply on news.ycombinator.com