I've been experimenting with two kinds of highlighting for comments: http://i.imgur.com/H1h7M.png (http://github.com/akkartik/wart/commit/b922700733#diff-17). The 'landmark' comments are in the lighter blue (cyan). They're often section headings, but not always. Notice how I highlight the parts of the repl, and connect up the parts of the read stage with later phases. This might help highlight the one key line in a large main function that leads to the true skeleton of the program.
Still, I'm not sure this is a good idea. Perhaps it's not that important, and the gains don't compensate for constantly thinking about how many comment leaders to type in each line. Perhaps it's something we shouldn't think about in the first draft of a new feature.
