Questions tagged [naming-standards]
The naming-standards tag has no usage guidance.
2
votes
1answer
46 views
Does any scale exist (e.g. naming convention to be used for sizes) that allows trivial insertions at any point in the scale?
Question probably sounds confusing so let me clarify.
Let's say I have an object containing keys and values for my project's font sizes:
{
small: '8px',
medium: '11px',
large: '14px',
}
...
7
votes
4answers
589 views
Is it a good practice to end a function's name with a preposition?
I have seen examples of methods whose name ended with a preposition applying to the first (and most often only) parameters.
But other examples don't use this kind of naming convention.
Which do you ...
0
votes
0answers
50 views
Does this format violate ISO 8601?: YYYY-MM-DD-HHMMSS
I'm reviewing best practices for naming things with a date and/or time, and it seems that ISO 8601 provides a solid foundation.
However, I see things here & there that seem to violate the ...
0
votes
1answer
124 views
Is there a rule of thumb when it comes to the “name” attribute?
Since there is things like BEM in naming conventions for HTML class attributes, does the name attribute have anything of that sort?
0
votes
1answer
49 views
What to specify as interfaces in component diagrams
I am following the textbook Object oriented software specification using UML, patterns and Java (3rd edition) and I am defining interfaces between system components (subsystems). But I encountered a ...
2
votes
1answer
168 views
Naming conventions for pure functions
Are there 'conventions' / best practices on naming pure functions?
For example:
adding numbers: add or sum?
calculating the square root: calcSqrt or sqrt?
reversing a list: reverse or reversed?
...
0
votes
3answers
188 views
Naming variable which describes that something is currenty in use
I'm creating a variable which should describe that an object is currently in use. Lets say we have a form with a password input, and I want to describe the state when someone is using that input.
Is ...
-1
votes
2answers
151 views
SQL Coding Naming convention: Variable same name as Columns
Is there a coding naming convention principal for SQL variables? Can variables be named the same as column names, I heard in different companies, this may cause confusion. However in C# below, its a ...
0
votes
1answer
78 views
Co-ordination between technologies following different naming conventions [duplicate]
Javascript community generally follows camel case naming convention, whereas while writing REST api URLs follow snake case naming conventions.
What would be the better naming convention for the ...
6
votes
1answer
245 views
Is it a good practice to redefine unavailable keywords as macros?
Is it a good practice to redefine unavailable keywords with macros?
I use GCC 4.8 in one of my projects which isn't exactly C11 standard compatible. At least not the extent of 4.9. But there are some ...
2
votes
1answer
312 views
How to name a Boolean variable that represents either of two options?
I'm developing an application with Python. I want to have a Boolean variable that represent whether something is buy or sell but I'm not sure how I should name it. Here are my current ideas:
isBuy
...
2
votes
1answer
209 views
Method naming: to vs as vs get
Do the words to, as and get have any special meaning when used in method names?
Examples
to
new Integer(4).toString()
get
Integer.getInteger("system.unknown.property",4)
as
Arrays.asList(...
0
votes
1answer
105 views
Is a URC (Uniform Resource Citation) synonymous with a Query String or Url Parameters?
Reading this:
https://renenyffenegger.ch/notes/development/web/URI-URL-URN-IRI-URC
URCs provide a set of attribute/value pairs that describe properties of URIs like authorship, publisher, ...
-3
votes
3answers
159 views
Ambiguous use of “User”
In one of my projects, I had to name some variables and functions that belong to the person using my app. I named them userCard, getUserInventory() and so on. I named them like that cause there were ...
0
votes
3answers
206 views
RESTful APIs: Terminology for Update Modes/Types
When designing a RESTful API, providing a spec for updating an entity will force the designer to make some decisions on how the update will behave (an update mode or type). Here are some of the modes ...
-3
votes
2answers
343 views
Writing readable code and not overdoing it with naming [closed]
I've been in an argument at work about writing readable code. It was mainly about variable and method names and the idea that comments are worthless if the code is readable enough. I would not like to ...
-2
votes
1answer
628 views
How to name different components in adapter pattern?
(example code in PHP, but this can apply to more languages)
I have a scenario with an adapter pattern, where I have classes, interfaces and objects with different roles, like so:
An original object ...
2
votes
4answers
500 views
Naming similar variables [closed]
I need few related variables (for example I have the lengths of 3 lines given. I have to say whether they form a triangle).
Which variable naming convention is preferable in Java?
len0, len1, len2 ...
-3
votes
1answer
67 views
What to call a API and DB code layer [closed]
In a recent MVVM mobile app project I wrote a set of API classes and Database classes where there was a clear flow of logic between both api and db code. To enforce the way api and db interacted I ...
0
votes
0answers
35 views
Best practice on naming an array (i.e. an array of image file names) [duplicate]
I have an array of image file names. e.g:
[
'a/b/foo.jpg'
'c/d/bar.jpg',
'example.png'
]
However, I am confused as to what the best practice of naming this array.
Would it be:
...
29
votes
2answers
7k views
Why does software use the Win32 name?
If a software/library has some support for the Windows platform they almost always name their directories and variables as win32. This is most prevalent in C/C++ projects. Even the MinGW project's ...
6
votes
2answers
1k views
What's the Java convention for names with a sequence of numbers, like “ISO 8859-1”?
If I'm creating a Java class for something that has a sequence of numbers in its name, e.g. “ISO 8859-1”, how should I name my class?
Iso88591 seems wrong, since there's no boundary between the ...
1
vote
0answers
789 views
Entity Framework naming conventions for the same table name across multiple schemas
The DbContext of my application's Entity Framework setup (which I will refer to as ApplicationContext, the name of our derived type) contains classes for all of the tables in our SQL Server database, ...
5
votes
2answers
613 views
Use of “my” prefix in object naming
I am refactoring a large code base, and noticing the author often uses "my" to prefix object names. For instance, using myThingy to identify an object of type Thingy. Is this generally considered a ...
1
vote
2answers
61 views
What's the standard term for removing data and embedded code modules from a database before publishing?
Hopefully this question isn't too application-specific; I'm thinking about it with regard to Excel, but I think it applies to any file-based database that includes embedded code.
I'm working on an ...
14
votes
8answers
7k views
C# - Why are prefixes on fields discouraged?
Back in the old days, we did Hungarian notation. That's now considered passé, and for the most part I don't use it anymore, but I still find use for the m_ prefix to indicate member fields.
For me, ...
3
votes
1answer
57 views
Naming a view class
I'm a little hesitant on what to name a view class.
I have a view class which I call ChooseImageView because that's what the user does in that view. After the user has chosen an image I display a ...
0
votes
1answer
694 views
Naming collections of helper methods, and avoiding meaningless jargon words
While coding anything remotely useful, I inevitably find myself wanting to add methods to perform smaller bits and pieces. (It could be a method to return everything in a string to the left of the ...
1
vote
2answers
682 views
JS: convention to distinguish immediate vs async methods
I normally have a laissez faire attitude on method naming conventions but now I am working on a module in JavaScript that will have some methods that can return the value directly (immediate / plain ...
3
votes
1answer
5k views
What is the best practice when it comes to naming microservices?
I come from a "monolithic" SOA API mindset where, lets say, there would only be one RESTful service for persistence (persistence-app). Now that I'm developing in a microservice environment, I believe ...
44
votes
2answers
11k views
Naming of bool methods: Is vs. Can vs.?
Which is the better name for a method that returns a boolean?
IsSupportContentType
or
CanSupportContentType
0
votes
3answers
2k views
How and why do we have underscores in variable naming
If I look in python code and sometimes maybe also in C codes, there is often two variables with the same name except for the underscore. For example two variables
variable1 data;
variable2 _data;
...
1
vote
4answers
732 views
Naming procedure conventions - Where to place adjective in a verb followed by an object convention
I am reading on Coding Complete book the following statement:
To name a procedure, use a strong verb followed by an object A
procedure with functional cohesion usually performs an operation on an
...
0
votes
2answers
145 views
How to name the classes that caries data to a different layer?
When I retrieve data from database I name the class as Model, for example UserModel.
When I send data to the View I name the class as ViewModel, for example UserSettingsViewModel.
How to name the ...
-1
votes
1answer
817 views
Do you name a dictionary by the key or the value? [closed]
Do you name a dictionary by the key or the value? I have a dictionary that will hold gradient data and the component:
dictionary[gradient] = component;
Do I name it gradientDictionary or ...
2
votes
3answers
287 views
Applying the label “Parent/Child” on inheritance vs composition
I just stumbled over an interesting problem with naming.
I am writing automated tests for an Object-Relational mapper.
This involves using super-generic classes that exist solely to exercise certain ...
2
votes
3answers
1k views
Naming convention for C# class that accesses a webservice
I apologize if this is a little vague, but I'm curious about what most people use for naming conventions for classes that access a webservice. Typically on my team we create separate projects for BLL ...
1
vote
0answers
62 views
Project Structure for intermediate level abstraction
This is really a question on higher level naming.
We have an API directory for classes that deal directly without outside APIs, and contain all the code to consume a specific API. We call this lib
...
2
votes
2answers
278 views
When should I use “value” as an argument name? [closed]
I'm building my own utility functions to master ES6:
const contains = (array, value) => {
return array.indexOf(value) > -1
}
const keys = (object) => {
return Object.keys(object)
}
...
-1
votes
1answer
144 views
How to name a class whose purpose is to hold related objects?
I am working in a wizard in WPF application. As the wizard gathers a lot of information I have designed separate view models for each step (view) in a wizard.
But I have to hold all this information ...
140
votes
17answers
29k views
Coding standard for clarity: comment every line of code?
I've worked in shops that produce life critical software and I've dealt with commenting rules that were meant to keep the code readable and potentially save lives. In my experience though the ...
2
votes
2answers
341 views
Choose best function name in repository [duplicate]
In my code, I'm using repository pattern. For example, I got deal repository. I just curious how you decide the name of the function when the function itself doing so many things. I think when the ...
1
vote
1answer
338 views
Is the -Impl suffix a legitimate naming convention for a Hook method in Java?
I was going over some old code and found the following peculiar naming convention at a template method implementation.
// TEMPLATE METHOD
// Checks condition and fail fast if condition is met.
// ...
2
votes
1answer
460 views
How to name Test Projects
Suppose I have some Modules that each are their own component
I would now have different Testprojects spanning different modules.
UnitB_UnitTest, UnitC_UnitTest, GUI_UnitB_ComponentTest, ...
8
votes
2answers
3k views
How should I name functions that return values in Python?
I'm confused about choosing names for my functions in Python. Sometimes Python built-in functions are imperative such as: print function and string method find. Sometimes they aren't such as: len its ...
1
vote
1answer
173 views
naming conventions / coding standards for methods in a service
At work, we are having 'arguments' about naming styles / conventions. Imagine having a service called UserSettingsService. This has 2 methods, one to get the user settings and one to save. Would you ...
3
votes
1answer
521 views
Why is Systems Hungarian commonly used in the VB world, and seemingly nowhere else?
Kind of as the title implies - I can understand why Apps Hungarian might crop up, but Systems Hungarian seems almost entirely pointless in a strongly-typed language. Why, then, is it so apparently ...
67
votes
8answers
9k views
Naming issues: Should “ISomething” be renamed to “Something”? [closed]
Uncle Bob's chapter on names in Clean Code recommends that you avoid encodings in names, mainly regarding Hungarian notation. He also specifically mentions removing the I prefix from interfaces, but ...
-1
votes
1answer
518 views
What to name package and their facade classes?
I'm using a some C++ Facade classes like this:
http://www.apwebco.com/images/Facade.png
Suppose that there is package named "SubSystem" with a lot of classes inside, like in the picture above.
I ...
-1
votes
1answer
143 views
What is the naming convention for this type of object [closed]
I have frequent "access" classes that implement interfaces / abstract classes.
These classes all have different classes/ dlls to execute the implemented method.
What naming convent is commonly ...
