Preguntas etiquetadas con naming

Solía ​​haber muy buenas razones para mantener cortos los nombres de instrucción / registro. Esas razones ya no se aplican, pero los nombres crípticos cortos siguen siendo muy comunes en la programación de bajo nivel. ¿Por qué es esto? ¿Es solo porque los viejos hábitos son difíciles de romper o …

64 naming  coding-standards  low-level 

Siempre es difícil para mí elegir entre formas singulares y plurales para nombres de clases: CustomerRepository vs. CustomersRepository CustomerService vs. CustomersService CustomerController vs. CustomersController Y para los nombres compuestos es aún más difícil: OrderCustomerRepository vs. OrderCustomersRepository vs. OrdersCustomersRepository ¿Qué enfoque prefieres y por qué?

58 naming  source-code 

El consenso parece ser que uno debe seguir la convención de la plataforma para la que se está desarrollando. Ver: Subrayado o camelcase? Convenciones de nomenclatura: camelCase versus underscore_case? Sin embargo, PHP no parece seguir estrictamente ninguna convención internamente (sin sorpresas allí), incluso para métodos y funciones (por ejemplo mysqli::set_local_infile_default, …

52 php  naming  readability  camelcase 

¿Cuál es el mejor nombre para un método que devuelve un valor booleano? IsSupportContentType o CanSupportContentType

51 naming  naming-standards 

¿Debo usar siempre iscomo prefijo para las variables booleanas? ¿Qué pasa con los booleanos que indican algo en el pasado? ¿Debo escribir isInitializedo wasInitialized? ¿Debo escribir para propiedades IsManyMemberso HasManyMembers? ¿Hay alguna mejor práctica? ¿O simplemente debería escribir de acuerdo con las reglas inglesas?

50 coding-style  naming  boolean 

Me he encontrado con un problema de esquina con la guía general de: sustantivos para variables verbos para funciones Específicamente, tengo un caso en el que la palabra es ambigua: puede ser un verbo o un sustantivo. Y en algunos casos, cuando estamos discutiendo la aplicación, se usará en ambos …

48 naming  variables 

Siempre tengo problemas para determinar si debo nombrar un cierto método comenzando con getSomethingversus findSomething. El problema reside en crear ayudantes para API mal diseñadas. Esto generalmente ocurre cuando se obtienen datos de un objeto, que requiere el objeto como parámetro. Aquí hay un ejemplo simple: public String getRevision(Item item) …

48 naming  methods 

A menudo veo códigos que incluyen errores ortográficos intencionales de palabras comunes que, para bien o para mal, se han convertido en palabras reservadas: klasso clazzpara la clase :Class clazz = ThisClass.class kountpara contar en SQL:count(*) AS kount Personalmente, encuentro que esto disminuye la legibilidad. En mi propia práctica, no …

45 coding-style  variables  readability  naming 

A menudo, cuando la sintaxis del lenguaje requiere que nombre una variable que nunca se usa, la nombraré _. En mi opinión, esto reduce el desorden y me permite centrarme en las variables significativas del código. Me parece discreto, por lo que produce un efecto "fuera de la vista, fuera …

44 language-agnostic  naming  readability  variables 

¿Es una buena práctica llamar a la variable que un método devuelve con un nombre de variable result? Por ejemplo: public Zorglub calculate() { Zorglub result = [...] [...] return result; } ¿O debería nombrarlo por su tipo? public Zorglub calculate() { Zorglub zorglub = [...] [...] return zorglub; } …

44 programming-practices  naming  variables 

¿Deberían los métodos booleanos tomar siempre la forma afirmativa, incluso cuando solo se utilizarán en forma negativa? Digamos que quería verificar si existe una entidad antes de crear una, mi argumento es que la primera forma a continuación es mejor que la segunda forma, ya sea que el método se …

44 naming  functions 

No estoy seguro de qué hacer con lo siguiente: Tomamos datos de una herramienta externa dentro de nuestra propia herramienta. Estos datos están escritos en holandés. Estamos escribiendo nuestro código Java en inglés. ¿Deberíamos traducir este holandés al inglés o mantenerlo holandés? Por ejemplo, tenemos 2 departamentos: Bouw (Construcción en …

39 naming  translate 

Saqué el término pitufo de aquí (número 21). Para salvar a cualquiera que no esté familiarizado con el problema, el nombramiento de pitufos es el acto de prefijar un grupo de clases relacionadas, variables, etc. con un prefijo común para que termines con "a SmurfAccountViewpasa a SmurfAccountDTOa SmurfAccountController", etc. La …

39 naming  coding-standards 

¿Es suficiente distinguir los métodos solo por el nombre del argumento (no el tipo) o es mejor nombrarlo más explícitamente? Por ejemplo T Find<T>(int id)vs T FindById<T>(int id). ¿Hay alguna buena razón para nombrarlo más explícitamente (es decir, agregar ById) en lugar de mantener solo el nombre del argumento? Una …

36 c#  naming  coding-standards  conventions  method-overloading 

Hay algunos nombres, donde si te encuentras buscando esos nombres, sabes que ya has desordenado algo. Por ejemplo: XxxManager Esto es malo porque una clase debe describir lo que hace la clase. Si la palabra más específica que se te ocurre para lo que hace la clase es "administrar", entonces …

35 naming  anti-patterns