News for hackers. Stuff that matters.
Re:Is naming things really that hard? by noobiemcfoob on Saturday March 04, 2017 @10:03AM (#13791145)
> I often notice that I can remove a comment line after renaming a few identifiers in the code below it, because the code starts to read self-explanatory enough.

Careful with that. I'm of the mind that the code author is incapable of describing how readable any codebase is. It's too easy to mistake your innate understanding of your own creation for readability.

Re:Is naming things really that hard? by chrisweekly on Saturday March 04, 2017 @02:26PM (#13792471)
Also, while good names might obviate the need for "what" comments, they can't replace often-invaluable "why" comments.
Re:Is naming things really that hard? by nine_k on Saturday March 04, 2017 @02:34PM (#13792521)
Good comments are usually about "why" and "what", while the code is about the "how".

Code with descriptive identifiers often make code read like plain English.