Cómo hacer que mi equipo compre en las guías de estilo de proyecto / programación

Las guías de estilo de codificación generalmente tienen dos partes, reglas sobre cómo se formatea el programa (colocación rizada, tabulaciones frente a espacios, colocación de comentarios, etc.) y reglas para el uso de características del lenguaje (no utilizará punteros sin formato, etc.).

Es poco probable que obtenga una aceptación universal. Los miembros de su equipo tienen diferentes estilos personales, que son hábitos. Lo que sabemos sobre los hábitos de la psicología es que las personas defienden sus hábitos con una ferocidad sombría. Los miembros de su equipo superior habrán atravesado una o más guerras de estilo en su carrera y gemirán con dolor anticipado cuando mencione el tema. Tendrá que imponer una guía de estilo desde arriba, aunque un buen equipo podría establecer las reglas reales por consenso.

Ayuda si instala un formateador que reescribe los archivos para que el espaciado y la colocación de los corchetes coincidan con su guía de estilo y un analizador que señale el uso que ha sido prohibido. Lo ideal sería que formatear y pasar el verificador de estilo sea parte del proceso de registro o fusión. Eso evita que las personas hagan trampa, ejem, sean flojos.

Esperemos que haya un estilo de consenso para que no todos los miembros del equipo tengan que aprender nuevos hábitos. Configure el formateador para que coincida con el estilo de consenso lo más cerca posible.

La razón por la que siente que necesita una guía de estilo es probablemente porque el equipo no ha podido establecer un estilo de consenso. Hay uno o más rebeldes que no se ajustan. Hay muchas razones por las cuales pueden elegir no conformarse; pereza, hábito o un sutil juego de poder de su parte. El gerente no podrá decir simplemente: “Formen un gremio de estilo juntos”. Desempolvarse las manos y alejarse. Sin embargo, es una oportunidad para relacionarse con el personal y hacer algo de trabajo en equipo.

Los buenos equipos generalmente ven el beneficio de un formato consistente en términos de legibilidad y el valor de las reglas que evitan que el uso sea peligroso. Para los equipos que todavía están aprendiendo a trabajar juntos, desarrollar reglas puede ser un ejercicio que reúna al equipo, pero también puede desgarrarlo si hay miembros del equipo que insisten absolutamente en salirse con la suya. Es un buen momento para que un gerente participe en las reuniones y se asegure de que el equipo en bruto establezca normas que conduzcan a un consenso y ponga a los acosadores en su lugar.

Hay ejemplos de guías de estilo en la naturaleza. Van desde muy breves hasta muy detallados. Si elige uno como el de Google, al menos puede decir: “Aquí hay una guía de estilo que una organización grande y exitosa ha encontrado útil”. Pero las guías de estilo, incluso las de Google, pueden ser bastante idiosincráticas. Deje que su equipo modifique las recomendaciones de la guía de estilo si hay consenso.