David Golden gave a presentation at YAPC::NA 2015 about how to write comments that stand out. He notes that while most syntax highlighters don't emphasize comments properly, comments should be used to draw attention to important things that may otherwise be overlooked. Golden encourages writing comments in a way that makes them visually distinct to better aid readers in understanding code.

1. Make Comments
Stand Out
David Golden
Senior Engineer, MongoDB
YAPC::NA 2015

2. Inspired by
Your Syntax Highlighter is Wrong
by James Fisher

3. “A comment may be used to
amplify the importance
of something that may
otherwise seem inconsequential”
— Clean Code by Robert Martin

4. “A comment may be used to
amplify the importance
of something that may
otherwise seem inconsequential”
— Clean Code by Robert Martin

5. “A comment may be used to
amplify the importance
of something that may
otherwise seem inconsequential”
— Clean Code by Robert Martin

6. Most syntax highlighters
get this wrong

10. Excess comments
stand out, too

13. For better comments,
make them stand out!