Formularios revisión de código

E10: Instrucciones para aplicar la técnica “Revisión de Código”
Consultar la hoja suplementaria para aplicar la técnica “Revisión de Código” con el Programa X a
medida que se leen las instrucciones
Lectura del código
1. Pone el nombre en el Formulario de abstracciones (E12) y en el de recogida de datos (E11).
2. Lee por encima el código para tener una idea general del componente. Si te parece
descubrir faltas mientras haces este paso a alguno de los dos siguientes, márcalas. No
obstante, no pierdas demasiado tiempo en hacer un análisis preciso de ellas.
3. Determina las dependencias entre las funciones individuales del código fuente, usando para
ello un árbol de llamadas. Normalmente las funciones ya estarán ordenadas en el código, de
tal modo que las funciones de bajo nivel (hojas) están al comienzo y las funciones de más
alto nivel (raíz) aparecen al final. Comienza aplicando la técnica de revisión de código con
las funciones hoja y sigue hacia la raíz.
4. Intenta entender la estructura de cada función individual identificando las estructuras
elementales (secuencias condicionales, bucles) y marcándolas. Combina las estructuras
elementales para formar estructuras más grandes hasta que hayas entendido la función
entera.
5. Trata de determinar el significado de cada estructura comenzando con la más interna y
anota el resultado en el formulario para tal propósito (E12). Usa números de línea (línea xy) cuando hagas eso. Evita utilizar conocimiento implícito que no resida en la estructura,
por ejemplo valores iniciales, entradas o valores de parámetros. Describe las partes lo más
funcionalmente posible. Mientras hagas eso, usa principios generalmente aceptados del
dominio de aplicación para mantener la descripción breve y entendible. Por ejemplo, en el
caso de búsqueda en un árbol, menciona “búsqueda en profundidad” en lugar de describir lo
que hace la búsqueda en profundidad.
6. Cuando hayas completado las abstracciones, incluyendo tu versión de la especificación del
programa, deberás “congelarlas”. Pasa al siguiente paso.
Búsqueda de inconsistencias
7. Recoge el Formulario para inconsistencias (E13) y la especificación del código (E01). Pon
el nombre al Formulario para inconsistencias.
8. Lee con detenimiento la especificación que se te ha entregado. Dicha especificación
describe el componente como un todo, no las funciones individuales. Detecta las posibles
inconsistencias comparando la especificación con tu descripción del componente. Escribe
las inconsistencias que hayas detectado en el formulario E13.
Para ello, numera las inconsistencias que hayas encontrado desde 1 hasta n en la columna
denominada “Nº Inc” (número de inconsistencia) del formulario para inconsistencias.
Describe la inconsistencia en las columnas a la derecha del número de inconsistencia.
9. Una vez creas que has detectado todas las inconsistencias, entrega todo el material a la
persona a cargo del experimento. Ya has terminado.
E11: Formulario de Recogida de datos para la Revisión de
Código
Identificador (Nombre y Grupo):
Antes de comenzar...
1. ¿Cuál es tu experiencia con el lenguaje de programación C?
Experiencia (relativa). Marca la escala apropiadamente. Las marcas entre cajas son válidas.
Estimación
Comparación
0
ninguna
1
conozco la
teoría
2
pequeños
ejercicios
3
usado en
prácticas
4
usado en un
desarrollo
5
experto
2. Experiencia (absoluta). Número de años:
Resultados
Para cada entrada referida al tiempo que ha transcurrido, deduce el tiempo que hayas tomado para
descansos, etc.
3. ¿A qué hora comenzaste el ejercicio de “revisión de código”? (hora:minutos)
4. ¿Cuánto tiempo necesitaste para construir las abstracciones? (horas:minutos)
5. ¿Cuántos niveles de abstracciones has generado?
6. ¿A qué hora comenzaste a buscar las inconsistencias? (hora:minutos)
7. ¿Cuánto tiempo necesitaste para encontrar las inconsistencias? (horas:minutos)
8. ¿A qué hora terminaste el experimento? (hora:minutos)
9. ¿Podrías asegurar que encontraste todas los fallos? Estima el porcentaje de fallos que has
encontrado (en %)
10. ¿Cómo de bien crees que has efectuado la revisión de código? Marca la escala
apropiadamente.
Estimación
Comparación
0
fatal
1
bastante mal
2
regular
3
bien
4
muy bien
5
perfectamente
E12: Formulario de abstracciones para la Revisión de Código
Identificador (Nombre y Grupo):
Abstracciones
Líneas
Abstracción
E13: Formulario de inconsistencias para la Revisión de Código
Identificador (Nombre y Grupo):
Nº
Inc.
Inconsistencias detectadas
Comportamiento esperado Número de líneas (comienzo, fin) de la abstracción y
explicación breve de la inconsistencia