El desarrollo del proyecto

a. La indentación

La primera regla consiste en respetar el alineamiento de las instrucciones (también denominado indentación de código). Las instrucciones de un programa tienen una relación de dependencia y el desplazamiento, que se materializa mediante la tabulación o grupo de espacios, representa la existencia de esta dependencia. Dicho de otra manera, las instrucciones que están en la misma línea vertical se ejecutarán las unas después de las otras, sin condición. Un desplazamiento indica que la instrucción más a la izquierda decide (o controla) la ejecución de las instrucciones alineadas a la derecha.

int x;  
int y;  
  
x = 2;  
y = 2 * x;  
  
if (x % 2 == 0) // decide la ejecución de la instrucción siguiente
  y = 3 * x; // esta línea se ejecuta de manera condicionada
 

Actualmente, la mayor parte de los entornos de programación descodifican la sintaxis sobre la marcha y organizan la indentación del programa, en lugar de hacerlo el desarrollador. Esta funcionalidad puede ser útil tanto para el principiante en programación como para aquel que busque controlar la lógica de su módulo.

b. Los nombres en los programas

Cada lenguaje (C++, VB, Java, C#...) se publica junto con las reglas de formación de nombres que se dan a las variables, objetos, clases y paquetes... A nivel de los compiladores, las restricciones son casi siempre las mismas: no comenzar por un número o un carácter especial (como el punto o la flecha). Los lenguajes PERL y PHP se distinguen por el uso de un prefijo que anuncia el carácter de las variables ($ para funciones escalares, @ para las listas o % para las tablas).

A continuación se muestran algunos ejemplos de reglas empleadas en la escritura de programas. Estas...

a. Los números de versión

Aparte de la moda de los fabricantes de software de etiquetar sus productos con el año de su probable comercialización (Office 2016, Symantec 2007...), muchos usuarios y desarrolladores hacen referencia al número de versión. Este número se compone normalmente de dos partes: la principal y la secundaria.

El primer número corresponde al índice principal de versión del software. El siguiente, al índice secundario. En principio, las evoluciones del índice secundario corresponden a los sucesivos mantenimientos de una versión principal y, así, no hay ruptura en el perímetro funcional de la aplicación. De esta manera las versiones 10.1 y 10.2 de un software comparten probablemente el mismo nivel de funcionalidades (noción de compatibilidad ascendente).

Algunas veces se completa esta identificación con otros índices:

Estos índices no están...

a. La gestión del código fuente y los elementos de trabajo

El código fuente se comparte con el software TFS Online, siguiendo la metodología Agile-Scrum. Cada tarea trata el conjunto de peticiones (requerimientos) y anomalías (errores), que se deben realizar durante el periodo (hito o tarea).

Los desarrolladores recuperan la última versión de un módulo de código fuente antes de modificarlo. Al final del día, archivan, en la medida de lo posible, sus modificaciones y comprueban, antes y después, que los proyectos compilen sin errores.

Cada vez que se archiva, hay que asociar el identificador del elemento de trabajo y después actualizar el estado: activo, en curso, terminado, corregido… Los testers son los encargados de controlar estos estados y pueden cerrar los puntos o bien reabrirlos. Finalmente, los puntos realizados se incluyen en una subtarea actual, para que los testers puedan determinar el perímetro de una versión.

La ejecución de las pruebas unitarias es una condición inicial para la validación de un elemento de trabajo (terminado o corregido). Las modalidades particulares de pruebas ya están integradas en los elementos de trabajo por los desarrolladores. 

b. La documentación

El código se comenta siguiendo las normas establecidas para el lenguaje de programación. Ángel insiste en la calidad de los comentarios y su pertinencia respecto del código que describen.

Hay herramientas de extracción automáticas que se aplican de manera periódica para asegurarse de la presencia de comentarios en el código.

Ángel exige que las especificaciones técnicas se elaboren a partir de los documentos proporcionados por los analistas:

c. Las revisiones

Las revisiones de código tienen lugar todas...