DEV Community

Discussion on: Friday Fun Post: fetch lyrics from a public API

stereoplegic profile image
Mike Bybee • Edited on

It's so funny to me when I hear "comments are a code smell" (how dare you not assume your code is so amazing anybody can pick it up in its entirety at first glance without documentation) but pilling on extra, nonstandard syntax - both inline and in separate definitions - somehow isn't to many of the same people claiming comments "smell."

Thread Thread
functional_js profile image
Functional Javascript Author • Edited on

Yes, one of the fallacies in the industry is the concept of "self-describing code".

As if just by choosing the right names for the identifiers, the code will clarify all ambiguity.

No such code will tell you "why" the code exists. And that is what most needs to be explained.