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...
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...
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...
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...
¿Cuál es el mejor nombre para un método que devuelve un valor
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
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,...
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 nombre...
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...
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...
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...
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á destinado a ser el programa en...
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...
¿Cuál es la historia detrás de la convención de nombrar constantes en mayúsculas? Mi intuición es que comenzó con el preprocesador C, donde las personas desarrollaron una práctica para nombrar macros de preprocesador en mayúsculas para que pudieran vivir efectivamente en un espacio de nombres...
Recibo muchas críticas de otros programadores debido a mi uso de una carcasa completa para todas mis variables. Por ejemplo, su programador típico usará employeeCountpara un nombre de variable, pero yo uso EmployeeCount. Utilizo una carcasa completa para todo , ya sea un método nulo, un método de...
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...
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...
En los viejos tiempos, hicimos notación húngara. Eso ahora se considera pasado y, en su mayor parte, ya no lo uso, pero todavía encuentro uso para el m_prefijo para indicar campos de miembros. Para mí, si estoy leyendo el código de otra persona y veo esto: count = 3; Supongo que countes una...
Supongamos que tengo un formulario en mi aplicación web donde los usuarios pueden subir una foto de perfil. Tengo pocos requisitos sobre el tamaño del archivo, las dimensiones, etc., pero cuando el usuario carga la imagen, ¿cómo debo nombrarlos en mi sistema? Supongo que debería ser consistente y...
Mi proyecto actualmente sufre problemas de nomenclatura ambiental. Diferentes personas tienen diferentes suposiciones sobre qué entornos deben nombrarse o qué designan los nombres, y está causando confusión al discutirlos. He investigado un poco y no he encontrado ningún estándar por ahí. Los...