Estándares de Programación y Evaluación

Los programas deben poder manejar adecuadamente situaciones inesperadas. Ejemplo: Si el programa toma dos números (A,B) y debe retornar el cociente (A/B), entonces debe contemplar situaciones como que el input este incompleto o que B tenga valor 0 (cero). En ambos casos debiera informar de las anomalías encontradas y proceder a la finalización del programa.

Si se requiere cierta funcionalidad que no es implementada, manejar por lo menos mensajes que informen de la falta de funcionalidad. Ejemplo: Si un programa debe implementar +, -, * y / para dos números (A,B), pero la división (A/B) no fue implementada, debe por lo menos leer los datos de entrada e informar que "La División no está implementada.".

Los nombres de variables y procedimientos deben ser significativos en relación a su significado. El uso de nombres como J, K, L, M, debe restringirse a variables de control de ciclos ( for K = 1 ... ), contadores cuyo significado resulte obvio (N para n parámetros), o variables nombradas directamente en la definición del problema (A y B si el problema es definido como "Encontrar el producto de dos enteros A y B.").

Nombrar variables y procedimientos utilizando el estilo mostrado en los siguientes ejemplos: Primer_Nombre o PrimerNombre, Fecha_Nac o FechaNac, Sdo_Inicial o SdoInicial, Calcular_Seguro_Social o CalcularSeguroSocial.

No deben usarse constantes no nombradas. Las únicas constantes permitidas deben ser las obvias tal como 1 en "for j = 1 ...".

Las constantes deben nombrarse en letras mayúsculas como TRUE = 1, FALSE = 0, etc.

Todos los operadores deber rodearse de un espacio antes y después del operador. Ejemplo: A = A + B.

Todas las rutinas deben ser precedidas por un comentario organizado de la siguiente forma:

//

// Procedure Valor_Futuro (Monto, Tasa, Meses: real): real;

//

// Toma tres valores: monto inicial, tasa de interés anual y meses. Retorna el valor

// futuro a los meses indicados dado el monto inicial y la tasa de interés

// indicada.

//

Comentarios internos a los procedimientos se sugiere que se hagan en la misma linea de código o en lineas separadas siempre con una linea blanca antes y después del comentario. Ejemplo:

//

// calcular formula hashing

//

Declaraciones de variables y de constantes cuyo nombre no sea auto explicativo, deben incluir un comentario indicando su significado.

Las rutinas deben mantenerse de un tamaño tal que sea relativamente fácil seguir su lógica de un solo vistazo. Una regla simple es que la parte de código de un procedimiento se pueda ver en no más de dos pantallas de texto.

Para todo programa, la mínima documentación requerida es la siguiente:

Descripción del problema en términos de los datos de entrada y de salida esperados.

Descripción general del método (algoritmo) utilizado para solucionar el problema. Esta documentación debe hacer referencia a la lógica principal

Listado del programa documentado.

Ejemplos de corridas: Dos juegos diferentes de datos de entrada con sus resultados.

Para las clases avanzadas, cada maestro indicará la documentación extra considerada estandar para esa materia. Ejemplo: Para Compiladores debiera incluirse un detalle de la gramática y el automata para procesarlo, para Análisis de Sistemas debiera incluirse el Diagrama de Alcance del Sistema, Diccionario de Datos (Datos elementales y compuestos, DFDs, y descripciones de procesos).

En todas las clases que tienen proyectos de programación debe aplicarse los conceptos y técnicas adquiridas en los cursos previos en especial todo lo referente a eficiencia. Ejemplo:Si en Compiladores se requiere que cada string sea buscada entre las palabras reservadas del lenguaje implementado, esta búsqueda debe implementarse eficientemente, ya sea con el uso de un árbol balanceado de búsqueda binaria o con el uso de una tabla de hashing. Si en un curso adelante de Estructura de Datos se requiere de un ordenamiento de datos, debe esperarse del uso de un método de ordenamiento eficiente en lugar del típico uso del ordenamiento por burbuja.

Todas los trabajos deben ser estrictamente individuales a excepción de los siguientes cursos: