DEV Community

Eric Meadows
Eric Meadows

Posted on

Code Comments Are Not Enough

If your code comments are sufficient enough to tell a story, why do we onboard engineers using pair programming?

Top comments (1)

Collapse
 
brense profile image
Rense Bakker

I never get onboarded using pair programming. There is usually some explanation required about the business domain, but other than that the code should speak for itself, without comments. For example i dont give two shits if you have a comment in your React component

// side-effects

followed by a bunch of useEffect hooks. I can already tell its a side-effect from the fact that it's wrapped in a useEffect hook...