PRINCIPIOS
ETICOS
El Principio del
Carácter Personal:
* Nuestro carácter está reflejado en
cada línea de código que escribimos, en cada informe que diseñamos, en cada
interfaz de usuario que construimos, en cada diagrama que hacemos.
La
cuestión no es si uno es capaz de escribir el mejor código posible, sino si se
preocupará por intentarlo. Si un programador carece de ciertos conocimientos o
de cierta experiencia, pero hace lo posible por escribir el código de forma
clara, entendible, bien comentada, de forma que muestre que al menos ha
invertido tiempo en aprender algunos fundamentos básicos, entonces habrá
actuado como debía con diligencia— y eso será obvio para un observador que lea
con atención.
El
Principio del Carácter Personal establece: Escribe tu código de
forma que refleje, y saque a relucir, solo lo mejor de tu carácter personal.
El Principio
de la Estética
*La estética trata sobre la
belleza y la elegancia, y de el valor de estas cualidades.
Un programador
debe esforzarse en conseguir la belleza, sin importar la herramienta o el
lenguaje de programación que esté utilizando. La belleza puede conseguirse a
muchos niveles, desde el alto nivel de la elegancia en el diseño del sistema
hasta el más bajo nivel de la apariencia visual del código en la pantalla. Ser
ordenado y claro cuenta.
El Principio de la Estética establece: Esfuérzate por conseguir la belleza y la elegancia en cada aspecto de tu trabajo.
El Principio
de la Claridad
*La claridad en el código es un estado
que debemos buscar activamente.
Hay una
diferencia entre claro y correcto, y muchas veces se confunden. La corrección
es siempre el principal interés del desarrollado, como debe ser. La corrección
lleva a que la sintaxis del código sea correcta a los ojos del compilador, que
el diseño de la interfaz cubra las necesidades del usuario, y que los
algoritmos que se implementan cumplan con sus requerimientos. Pero si no se
dedica una atención igual a la claridad, la comprensibilidad y la mantenibilidad
del código sufrirán mucho. Para que nuestro código sea lo más claro posible,
debemos deliberadamente usar técnicas como la utilización de identificadores
descriptivos, la modularidad, los espacios en blanco, la cohesión del código,
el acoplamiento débil del código, propiciar la fácil realización de las pruebas
y la documentación, y comentar adecuadamente.
El Principio de la Claridad
establece: Dale el mismo valor a la claridad que a la corrección. Utiliza
activamente técnicas que mejoran la claridad del código. La corrección vendrá
casi por sí sola.
El Principio
de la Distribución
*Este principio se refiere a la
distribución visual del código. El Principio de la Distribución es un corolario
a los dos principios anteriores: El Principio de la Estética y El Principio de
la Claridad. El Principio de la Estética nos dice que, además del disfrute
intelectual que supone la lectura de código bello y elegante, la propia belleza
y la elegancia juegan un papel crucial para conseguir dicho buen código. Por
otro lado, El Principio de la Claridad nos dice que hagamos nuestro código lo
más claro posible a un lector humano, y que la claridad va de la mano con la
corrección. El Principio de la Distribución pone estos dos principios duales en
práctica.
Hay varias
técnicas que aseguran que la distribución visual del código ayude a entender su
estructura lógica. Estas técnicas deben formar parte de los conocimientos
fundamentales de todo programador
El Principio de la Distribución establece: Usa la distribución visual de tu código para comunicar la estructura de tu código a un lector humano.
El Principio
de lo Explícito
*Seguir el Principio de lo
Explícito nos ahorrará, a nosotros y a nuestros sucesores, innumerables
problemas. El Principio de lo Explícito es un corolario de El Principio de la
Claridad. Pero el Principio de la Claridad nos dice que hagamos nuestro código
de forma clara y entendible para el lector humano. Y el Principio de lo
Explícito también se aplica a esa misma entendibilidad, y a lo que es más
importante, a hacer nuestro código más tolerante a cambios.
El Principio de lo Explicito establece: Intenta siempre favorecer lo explícito sobre lo implícito.
El Principio
del Código Auto-Documentado
*Como desarrolladores, debemos
esforzarnos en el desarrollo de un estilo de codificación sólido, lo cual es la
clave del código auto-documentado. Debemos estar constantemente mejorando y
perfeccionando nuestro estilo, de forma que cada programa que escribimos sea
mejor que el anterior. Un estilo bien desarrollado se consigue incorporando
técnicas probadas, como el uso de identificadores informativos y consistentes;
la modularización bien cohesionada y acoplada; evitar el uso de técnicas
difíciles de comprender; hacer una buena distribución visual del código; dar
nombres adecuados a las constantes; probando y documentando las suposiciones; y
muchas otras.
Visto de cerca, el código verdaderamente
auto-documentado es un placer de contemplar, y a su observador le queda claro
que esa maravilla solo pudo ocurrir mediante el esfuerzo de un ingeniero de
software concienzudo y diligente.
El Principio de Código Auto-Documentado establece: La documentación más fiable para el software es el propio código. En
muchos casos, el propio código es la única documentación. Por lo tanto,
esfuérzate en hacer que tu código sea auto-documentado, y allí donde no sea
posible, añade comentarios.
El Principio
de los Comentarios
*Los comentarios son armas de
doble filo. Usados correctamente, pueden mejorar infinitamente la entendibilidad
y el mantenimiento del código. Usados de forma indebida, pueden hacerlo confuso
y menos legible. Comentar indebidamente es en el mejor de los casos de poca
ayuda, y en el peor de los casos un enorme desastre.
El Principio de los Comentarios establece: Comenta mediante frases completas para resumir y
comunicar la intención.
