Preguntas etiquetadas con readability

Suponga una interfaz que contiene estos métodos: Car find(long id); List<Car> find(String model); ¿Es mejor cambiarles el nombre de esta manera? Car findById(long id); List findByModel(String model); De hecho, cualquier desarrollador que use esta API no necesitará mirar la interfaz para conocer los posibles argumentos de los find()métodos iniciales . …

14 design  naming  readability  method-overloading 

Hace poco sugerí que se implementara un método de encadenamiento para una clase determinada en un proyecto determinado para que se pudiera mejorar la legibilidad del código. Obtuve una respuesta de "las interfaces fluidas no deberían implementarse solo por conveniencia, sino por semántica" y mi sugerencia fue rechazada. Respondí que …

14 architecture  coding-standards  readability  method-chaining 

Tengo un montón de clases que se ocupan de la validación de valores. Por ejemplo, una RangeValidatorclase verifica si un valor está dentro del rango especificado. Cada clase de validador contiene dos métodos: is_valid(value)que devuelve Trueo Falsedepende del valor, y ensure_valid(value)que busca un valor específico y no hace nada si …

13 unit-testing  exceptions  readability 

Cuando tiene que iterar un lector donde se desconoce el número de elementos para leer, y la única forma de hacerlo es seguir leyendo hasta llegar al final. Este es a menudo el lugar donde necesita un bucle sin fin. Siempre existe el trueque indica que debe haber una declaración …

13 c#  code-quality  readability 

En la mayoría de los lenguajes de programación, las variables no tienen caracteres de identificación como en PHP. En PHP debe anteponer una variable con el $carácter. Ejemplo; var $foo = "something"; echo $foo; Estoy desarrollando un nuevo lenguaje de secuencias de comandos para una aplicación comercial, y mis usuarios …

13 programming-languages  readability 

Soy nuevo en Clojure. Puedo entender el código que escribo pero se vuelve demasiado difícil de entender más tarde. Se hace difícil hacer coincidir los paréntesis. ¿Cuáles son las convenciones genéricas a seguir con respecto a las convenciones de nomenclatura y la sangría en diversas situaciones? Por ejemplo, escribí un …

13 readability  clojure 

Estaba escribiendo una declaración if con nombres de propiedad bastante largos y encontré este problema. Digamos que tenemos una declaración if como esta: if(_someViewModelNameThatIsLong.AnotherPropertyINeedToCheck == someValue && !_someViewModelNameThatIsLong.ThisIsABooleanPropertyThatIsImportant) { //Do something } La segunda propiedad es de tipo booleano y no tiene sentido tener el stetement como if(boleanValue == true) …

13 readability 

Cerrada . Esta pregunta necesita estar más centrada . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que se centre en un problema solo editando esta publicación . Cerrado hace 2 años . Tengo curiosidad sobre esto porque recuerdo que antes de aprender cualquier lenguaje …

13 object-oriented  functional-programming  readability 

Tengo entendido que las [Flag]enumeraciones se usan generalmente para cosas que se pueden combinar, donde los valores individuales no son mutuamente excluyentes . Por ejemplo: [Flags] public enum SomeAttributes { Foo = 1 << 0, Bar = 1 << 1, Baz = 1 << 2, } Donde cualquier SomeAttributesvalor puede …

12 c#  .net  readability  enum 

Intento seguir el Principio de responsabilidad única (SRP) y también omitir las repeticiones de código. Sin embargo, a menudo hay lugares donde hay repeticiones de código que no son más que bloques de invocaciones de código que son resistentes a extraerlas en un método con un nombre al menos significativo: …

11 refactoring  readability  single-responsibility  code-reuse 

Recientemente realicé una refactorización de un proyecto de tamaño mediano en Java para volver y agregar pruebas unitarias. Cuando me di cuenta de lo difícil que era burlarse de los solteros y las estadísticas, finalmente "entendí" lo que he estado leyendo sobre ellos todo este tiempo. (Soy una de esas …

11 coding-standards  readability  coding-style  static-methods 

¿Cuál se consideraría más mantenible? if (a == b) c = true; else c = false; o c = (a == b); He intentado buscar en Code Complete, pero no puedo encontrar una respuesta. Creo que el primero es más legible (literalmente puedes leerlo en voz alta), lo que también …

11 .net  code-quality  readability  maintainability  clean-code 

Estoy trabajando en un proyecto en Delphi y estoy creando un instalador para la aplicación, hay tres partes principales. Instalación / desinstalación de PostgreSQL instalación / desinstalación de myapplication (la configuración de myapplication se crea usando nsi). Creación de tablas en Postgres a través de script (archivos por lotes). Todo …

11 code-quality  readability  logging 

Supongo que esta pregunta se marcará de inmediato como subjetiva, pero ¿cuál crees que es mejor? double volume(double pressure, double n_moles, double temperature) { return n_moles * BOLTZMANN_CONSTANT * temperature / pressure; } o double volume(double P, double n, double T) { return n*R*T/P; } En otras palabras, ¿deberían las …

11 math  coding-style  readability 

¿Cuál de estos es mejor para la mantenibilidad? if (byteArrayVariable != null) if (byteArrayVariable .Length != 0) //Do something with byteArrayVariable O if ((byteArrayVariable != null) && (byteArrayVariable.Length != 0)) //Do something with byteArrayVariable Prefiero leer y escribir el segundo, pero recuerdo leer en código completo que hacer cosas así …

11 programming-practices  coding-standards  maintenance  readability