From Jason Turner
Watch on YouTube

Summary

In this episode, Jason explores whether code comments should be considered a 'code smell' - a characteristic that might indicate deeper problems in the code. He clarifies that a code smell does not mean something should never be done, but rather serves as a warning sign to investigate. Through a simple example, Jason demonstrates how comments that explain what a function does could be eliminated by using more descriptive function and variable names. He challenges viewers to consider whether comments might indicate opportunities to make code more self-documenting, sparking a discussion about when comments provide genuine value versus when they compensate for unclear code.

Resources

Tags