News for hackers. Stuff that matters.

A comment on Cognitive Biases in Software Development. Parent comment

Re:Cognitive Biases in Software Development by bigpeet on Tuesday March 31, 2020 @02:50AM (#22735428)
There should be naming guidelines just like how a team should have style guidelines. The discussions should happen when creating (or updating) these guidelines.

Then these guidelines should be followed, no need for long discussions during code reviews.

Variable name does not follow guidelines => Mark it as an issue, defer to the guidelines move on.

[ Parent | on HN ]
Re:Cognitive Biases in Software Development by raverbashing on Tuesday March 31, 2020 @03:07AM (#22735483)
Some people will just find it as an excuse to go all over it the naming issue. Worse than the "80 columns is the limit" people, because after all 80 columns is 80 columns. But there's no "ideal name" for some people.
[ Parent | on HN ]
Re:Cognitive Biases in Software Development by closeparen on Tuesday March 31, 2020 @12:56PM (#22739584)
No. The purpose of a name is to convey meaning to the reader. There is exactly one valid complaint about a name: “I’ve read this carefully and I still don’t know what it means.”

A standards-compliant name that interferes with understanding is not okay. A name everyone gets, which happens to not follow a rule in some rulebook, is probably fine.

[ Parent | on HN ]