Comentarios de prólogo de módulo: o Función del módulo o Descripción de interfaz Ejemplo de llamada Descripción de argumentos Lista de módulos subordinados o Explicación de datos, restricciones y limitaciones (importantes) o Historia del desarrollo Describir código en bloque y no en líneas Utilizar líneas en blanco y tabulación Comentarios correctos (mal interpretado es peor que nada)
2.- DECLARACION DE DATOS
Todas las variables explícitas
Ordenadas alfabéticamente
3.- CONSTRUCCION DE SENTENCIAS
Una sentencia por línea
Evitar utilizar complicadas comparaciones condicionales Eliminar comparaciones con condiciones negativas Evitar gran anidamiento de bucles o condiciones Utilizar paréntesis para clarificar expresiones lógicas y matemáticas Utilizar espacios o símbolos claros para mejorar legibilidad de las sentencias Utilizar solamente sentencias del standard ANSI Pensar: “podría yo entender esto si no fuera quien lo codificó?”