Ellen Spertus

Ellen Spertus is a computer science professor at Mills College and has worked as a developer and researcher at Mozilla, Google, and Microsoft. Her interests include increasing access to CS education and socially beneficial software.
code-for-a-living December 23, 2021

Best practices for writing code comments

While there are many resources to help programmers write better code—such as books and static analyzers—there are few for writing better comments. While it's easy to measure the quantity of comments in a program, it's hard to measure the quality, and the two are not necessarily correlated. A bad comment is worse than no comment at all. Here are some rules to help you achieve a happy medium.