Skip to main content Accessibility Feedback

How to write good comments

Dr. Kate Compton shared this delightful little one-sentence gem about how to write good comments on Twitter last week…

Programming pro tip: In your comments, write what you did and why, record your level of petulance (REALLY) and the StackOverflow link that made you realize something

She also shared a sample comment, which I’ve converted to JSDoc style.

 * Copy into the local scope
 * NOTE: this has issues with scope for eval'ing list comprehensions, which sucks
 * {@link}

I love it!