Code is poetry

Con solo observar el código de un desarrollo se pueden deducir varias cosas sobre la persona que lo escribió; el código es al programador lo que los ojos al alma. Un código ordenado, documentado e identado es una condición necesaria para alcanzar un desarrollo de calidad, porque un código escrito bajo estos parámetros facilita cualquier mejora posterior. Es tan importante este aspecto estético del código que sobre estas normas de escritura hay mucha documentación disponible en línea. La siguiente es la lista de las más comunes:

• Escribe funciones, métodos y clases con nombres descriptivos, y preferiblemente en inglés.
• Usa nombres capitalizados para clases, y nombres en minúsculas para funciones y métodos.
• Usa un prefijo descriptivo para las funciones que no hagan parte de una clase.
• Agrupa las clases, funciones y métodos con elementos comunes en un archivo con un nombre descriptivo.
• Identa y documenta, preferiblemente en inglés, para facilitar la lectura del código.

Personalmente sigo las recomendaciones de codificación de la GNU, normas que han sido puestas a prueba por miles de proyectos y han demostrado ser eficaces para alcanzar dos objetivos esenciales. El primero de estos objetivos es facilitar el seguimiento del código y su lectura, y el segundo es poder compartir el código con programadores de todo el mundo.

Si un código se ha de publicar en Internet es muy probable que el objetivo tras este comportamiento altruista sea captar el mayor número de desarrolladores posible, y para lograr que una persona en cualquier parte del mundo pueda entender lo que está escrito en el código es necesario hacerlo visualmente legible, y en un idioma común al grupo que lo va a leer.

Regla de la codificación: crea código para hackers.

Si no entiendes esta regla de seguro que aun falta tiempo para que tu código pueda ser publicado en Internet.

Capí­tulos: | Anterior | Prefacio | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | Siguiente |