Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Where do we draw the line with vocabulary when naming? [closed]

The other day I was looking through our code and I came across a class name IdempotentObject I didn't know what this meant at the time so I questioned whether it was a poorly chosen name. I found out who wrote it and asked the developer why he had named it so confusingly. He was surprised that I didn't know what it meant and told me that it was a well chosen name because the object is Idempotent.

On one side I see an argument for keeping it simple and having everyone understand what everything is at first reading. On the other hand we have the idea that we should name things precisely and if you don't know the meaning look it up.

Which one is better, precise or easy to understand at a glance?

like image 345
Andrew Clark Avatar asked Mar 03 '09 16:03

Andrew Clark


People also ask

Where is line Draw word?

On the Insert tab, in the Illustrations group, click Shapes. Under Lines, right-click the line or connector that you want to add, and then click Lock Drawing Mode. Click where you want to start the line or connector, and then drag the cursor to where you want the line or connector to end.

How do you draw a line in a Word document?

Draw a lineOn the Insert tab, select Shapes. Under Lines, select any line style you like. Select a location in the document, hold and drag your pointer to a different location, and then release the mouse button.

How do you name a line?

A line can be named either using two points on the line (for example, ↔AB ) or simply by a letter, usually lowercase (for example, line m ). A line segment has two endpoints. It contains these endpoints and all the points of the line between them. You can measure the length of a segment, but not of a line.

What are the lines of an angle called?

An angle is a geometrical figure that is formed when two lines intersect each other in the same plane. The lines that form an angle are termed as its arms (sides) and the point at which they form the angle is called its vertex.


1 Answers

No offence, but anybody with a CS degree or who hopes to practice in the field should recognize the term "Idempotent" as having a specific meaning in computer science even if you don't know the term and have to look it up.

On the other hand, I don't think objects should have the word "Object" in the name - that's redundant.

Now, if it were called "IdempotentDataAccessor" or something that is both precise and descriptive, that would be good.

like image 158
Paul Tomblin Avatar answered Oct 17 '22 17:10

Paul Tomblin