Preguntas etiquetadas con readability

¿Cómo se podría saber si el código que se ha creado es fácilmente legible, comprensible y mantenible? Por supuesto, desde el punto de vista del autor, el código es legible y mantenible, porque el autor lo escribió y lo editó, para empezar. Sin embargo, debe haber un estándar objetivo y …

336 code-quality  code-reviews  readability  maintainability 

Mi jefe sigue mencionando con indiferencia que los malos programadores usan breaky continueen bucles. Los uso todo el tiempo porque tienen sentido; déjame mostrarte la inspiración: function verify(object) { if (object->value < 0) return false; if (object->value > object->max_value) return false; if (object->name == "") return false; ... } El …

191 coding-style  language-agnostic  syntax  readability  control-structures 

Todos los programadores parecen estar de acuerdo en que la legibilidad del código es mucho más importante que las líneas simples sintaxis que funcionan, pero requieren que un desarrollador senior interprete con algún grado de precisión, pero esa parece ser exactamente la forma en que se diseñaron las expresiones regulares. …

160 readability  regular-expressions 

En general, uso métodos privados para encapsular la funcionalidad que se reutiliza en varios lugares de la clase. Pero a veces tengo un gran método público que podría dividirse en pasos más pequeños, cada uno en su propio método privado. Esto acortaría el método público, pero me preocupa que obligar …

139 coding-style  readability 

Cuando escribo código, siempre trato de hacer mi código lo más limpio y legible posible. De vez en cuando llega un momento en que necesita cruzar la línea y pasar de un código limpio agradable a un código un poco más feo para hacerlo más rápido. ¿Cuándo está bien cruzar …

67 performance  optimization  quality  readability  maintainability 

Entonces, mirando alrededor, noté algunos comentarios sobre los métodos largos como una mala práctica. No estoy seguro de estar siempre de acuerdo en que los métodos largos son malos (y me gustaría recibir opiniones de otros). Por ejemplo, tengo algunas vistas de Django que procesan un poco los objetos antes …

64 readability  methods 

¿Qué es más fácil de entender, una gran declaración booleana (bastante compleja) o la misma declaración desglosada en métodos predicados (mucho código adicional para leer)? Opción 1, la gran expresión booleana: private static bool ContextMatchesProp(CurrentSearchContext context, TValToMatch propVal) { return propVal.PropertyId == context.Definition.Id && !repo.ParentId.HasValue || repo.ParentId == propVal.ParentId && …

63 c#  readability 

Mientras revisaba mi código aquí,const surgió el problema del uso de la palabra clave. Entiendo que se usa para implementar el comportamiento de solo lectura en las variables. Estoy confundido acerca de cuáles son las diversas situaciones cuando puede ser útil. ¿Debería usarse por razones de claridad en los prototipos …

59 c  readability  patterns-and-practices  const 

Mi estilo de codificación para llamadas a funciones anidadas es el siguiente: var result_h1 = H1(b1); var result_h2 = H2(b2); var result_g1 = G1(result_h1, result_h2); var result_g2 = G2(c1); var a = F(result_g1, result_g2); Recientemente me cambié a un departamento donde se usa mucho el siguiente estilo de codificación: var …

57 c#  c++  coding-style  readability  maintainability 

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 

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 

Me confundo sobre las funciones mínimas y máximas, en ciertos contextos. En un contexto, cuando usa las funciones para tomar el mayor o menor de dos valores, no hay problema. Por ejemplo, //how many autographed CD's can I give out? int howManyAutographs(int CDs, int Cases, int Pens) { //if no …

40 design  functions  readability 

Cuando se utiliza el método de encadenamiento como: var car = new Car().OfBrand(Brand.Ford).OfModel(12345).PaintedIn(Color.Silver).Create(); Puede haber dos enfoques: Reutilice el mismo objeto, así: public Car PaintedIn(Color color) { this.Color = color; return this; } Cree un nuevo objeto de tipo Caren cada paso, así: public Car PaintedIn(Color color) { var car …

37 coding-style  readability  method-chaining 

¿Deberías sacrificar la legibilidad del código con la eficacia del código? por ejemplo, 3 líneas de código en 1 línea. Leí en Code Craft por Pete Goodliffe que la legibilidad es la clave. ¿Tus pensamientos?

37 code-quality  performance  optimization  readability