Preguntas etiquetadas con naming-standards

He trabajado en tiendas que producen software crítico para la vida y me he ocupado de las reglas de comentarios destinadas a mantener el código legible y potencialmente salvar vidas. En mi experiencia, sin embargo, el requisito se convierte en una tarea de muerte cerebral para ser eliminada de una …

142 coding-standards  comments  standards  naming-standards  standardization 

He visto esta parte de PEP-8 https://www.python.org/dev/peps/pep-0008/#package-and-module-names No tengo claro si esto se refiere al nombre de archivo de un módulo / clase / paquete. Si tuviera un ejemplo de cada uno, ¿deberían los nombres de archivo estar en minúsculas con guiones bajos si corresponde? ¿O algo mas?

139 python  coding-style  naming-standards 

El capítulo del tío Bob sobre nombres en Clean Code recomienda evitar las codificaciones en los nombres, principalmente en relación con la notación húngara. También menciona específicamente la eliminación del Iprefijo de las interfaces, pero no muestra ejemplos de esto. Asumamos lo siguiente: El uso de la interfaz es principalmente …

68 c#  naming  clean-code  naming-standards 

Viniendo de un fondo principalmente de c #, estoy acostumbrado a usar el término "interfaz" para describir un objeto sin implementación que defina el comportamiento. En c #, la convención es anteponer nombres de interfaz con "I", como en IEnumerable, etc. Por supuesto, el concepto tiene diferentes nombres en diferentes …

53 naming-standards  swift-language 

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

51 naming  naming-standards 

Si hay un método bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } ¿debería ser llamado IsStuffDone()? El usuario puede malinterpretar ambos nombres: si el nombre es DoStuff()por qué devuelve un valor booleano? Si el nombre es, IsStuffDone()no está claro …

33 naming  methods  naming-standards  parameters  return-type 

Acabo de bifurcar un proyecto en Github, hice mis cambios, etc. Esto me hizo preguntarme: veo principalmente README.txt en proyectos de código abierto y el archivo que edité fue Readme.txt. ¿Es esto algún tipo de estandarización o debería haberlo dejado como está?

33 naming-standards 

Si un software / biblioteca tiene algún soporte para la plataforma Windows, casi siempre nombran sus directorios y variables como win32. Esto es más frecuente en proyectos C / C ++. Incluso el triple objetivo del proyecto MinGW utiliza win32. ¿Hay alguna razón para esto? ¿Por qué no usar un …

31 coding-standards  naming-standards 

He estado trabajando con el objeto XMLHttpRequest en JavaScript recientemente, y no pude evitar notar que la carcasa de este nombre no tiene sentido. ¿Por qué 'XML' está todo en mayúsculas mientras que 'Http' no? ¡Ambas son siglas! Seguramente tendría más sentido que el nombre sea uno de los siguientes: …

28 javascript  naming  xmlhttprequest  naming-standards 

Es una convención bastante establecida que los nombres de tablas de bases de datos, al menos en SQL, deben ser singulares. SELECT * FROM user;Vea esta pregunta y discusión . También es una convención bastante establecida que los nombres de recursos RESTful API deben ser plurales. GET /users/123yPOST /users mira …

27 rest  api  sql  conventions  naming-standards 

Esta pregunta se migró de Stack Overflow porque se puede responder en Software Engineering Stack Exchange. Migrado hace 8 años . Estoy empezando a aprender C #. Viniendo de un fondo en Java, C ++ y Objective-C, encuentro que Pascal-Cing de C # sus nombres de métodos son bastante únicos, …

22 c#  programming-languages  history  naming-standards 

Java SE 8 viene con un nuevo mecanismo de fechas, la introducción LocalDate, LocalTimey LocalDateTimeclases para representar instantes de tiempo. Para manipular esos instantes, se dan una serie de métodos: LocalDate.plusDays(...), LocalDate.minusDays(...)y así sucesivamente. Siempre he pensado que una buena práctica era nombrar métodos después de los verbos que describen …

21 java  methods  naming-standards 

Después de leer la respuesta de gnat a ¿Por qué un método principal estático en Java y C #, en lugar de un constructor? Supongo que su respuesta significa que el propósito de una clase Java con un método principal estático es define a program entry pointy que no está …

21 java  naming  naming-standards  entry-point 

Cerrada . Esta pregunta está basada en la opinión . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que pueda ser respondida con hechos y citas editando esta publicación . Cerrado hace 4 años . Cuando se usan variables en las cuales su plural y …

20 c#  naming  naming-standards  language-discussion 

Estoy trabajando en un proyecto que trata con dispositivos físicos, y me ha confundido cómo nombrar correctamente algunas clases en este proyecto. Teniendo en cuenta que los dispositivos reales (sensores y receptores) son una cosa, y su representación en el software es otra, estoy pensando en nombrar algunas clases con …

20 c#  .net  naming  class-design  naming-standards