Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Universidad de Tarapaca

Estndar para el proceso

Revisiones tcnicas
[[14 -09-2015]]
Versin 1.0

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Informacin del documento

Ttulo

Identificador

Gua para la elaboracin de inspecciones.

EV-1.0
Versin

1.0
Archivo

Estndar.doc
Autor

Fecha
Enzo Videla

Estado
14-09-2015

Completado

Aprobacin del documento

Gerente Tcnico

<firma>

14-09-2015

<firma>

14-09-2015

<firma>

<fecha>

<firma>

<fecha>

<firma>

<fecha>

<Enzo Videla>
Ingeniero de SQA

<Enzo Videla>
[[cargo/posicin]]

<nombre>
[[cargo/posicin]]

<nombre>
[[cargo/posicin]]

<nombre>

Registro de cambios
Nro. de
cambio

Fecha

Tipo(1)

Descripcin del cambio

Autor

14-09-2015

2
2

16-09-2015

A
A-M
A-M

Inicio del estndar

Etapas de introduccin completadas
Etapa de desarrollo completada

E.Videla
E.Videla
E.Videla

19-09-2015

Nro. de
Peticin

(1) A: Agregar M: Modificar E:Eliminar

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Tabla de Contenidos
1

2
3

Introduccin.........................................................................................................................................3
1.1
PROPSITO......................................................................................................................................3
1.2
DESCRIPCIN DEL DOCUMENTO.....................................................................................................3
1.3
ACRNIMOS....................................................................................................................................3
Importancia..........................................................................................................................................4
Historia del modelo................................................................................Error! Marcador no definido.
3.1
DEFINICIONE..5
3.2
OBJETIVO DE LAS REVISIONES TECNICAS..............................ERROR! MARCADOR NO DEFINIDO.
3.5
PROCEDIMIENTOS Y PROTOCOLOS........................................ERROR! MARCADOR NO DEFINIDO.
Elavoracion del proceso.......................................................................................................................6
4.1
ROLES....................................................................................ERROR! MARCADOR NO DEFINIDO.
4.2
PROCESOS..............................................................................ERROR! MARCADOR NO DEFINIDO.
4.2
INFORMES GENERADOS......7
Apendice...............................................................................................................................................9
5.1
Otros modelos..10
5.2
Cuadro de comparacin...11
5.3
Conclusiones12

Proceso de revisiones tcnicas

Versin 1.0

2
2.1

[[Enzo Videla]]
[[14-09-2015]]

Introduccin
Propsito
El presente documento define y describe los principales tpicos por considerar durante la
elaboracin de un proceso de revisin tcnica de software.
El objetivo de las inspecciones es detectar defectos sin examinar porque surgieron ni cmo se
resuelven. Es necesario detectar estos errores antes de pasar a la siguiente etapa de ingeniera del
software y antes que se entregue el producto final al cliente.
En el presente documento se da a presentar el modelo de inspecciones de software segn el autor
M.C Fagan.

Este cuadro representa una accin en la ingeniera del software.

Durante esta accin los errores se pueden generar de manera inadvertida.

2.2

Descripcin del documento: Desarrollo

Capitulo 1
Captulo 2
Capitulo 3
Captulo 4

2.3

Introduccin: Propsito, acrnimos.

Importancia: Necesidad del documento.
Historia: El modelo de inspeccin de Fagan.
Elaboracin del proceso: detalle de la forma en que se desarrollan las revisiones
tcnicas en la empresa Villasoft

Acrnimos
<Lista de las abreviaciones utilizadas en el documento. >
Acrnimo
DoD
EIA
IEC
IEEE
ISO
NIST
SQA
SCM

Significado
Departament of Defense
Electronic Industries Association
International Electrotechnical Commission
Institute of Electrical and Eletronics Engineers
International Organization for Standardization
National Institute of Standards and Technology
Software Quality Assurance
Software Configuration Management

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Importancia

Es de general conocimiento que la calidad de los productos de software es deficiente, no solo

porque no satisface los requerimientos del cliente, sino porque los tiempos de entrega y presupuestos
planificados no se cumplen.
Esta falta de calidad, evidencia tambin en los procesos de desarrollo de software y se
manifiesta en el incumplimiento de los presupuestos y cronogramas previamente planificados y en los
productos finales liberados al mercado con fallas. Si bien los productos, ya ensamblados, son sometidos a
testing hay errores que no son posibles de detectar en esta etapa, como por ejemplo requerimientos no
especificados, condiciones donde un algoritmo produce resultados incorrectos, etc. Las inspecciones de
software cubren parcialmente estas falencias de testing, mejorando la calidad de los productos de software
reduciendo costos y tiempos de desarrollo.
Las inspecciones son revisiones de subproductos del proceso de desarrollo de software que se
efectan durante todo el ciclo del mismo, por lo tanto permite encontrar tempranamente defectos en los
productos y pasar a etapas siguientes sobre una base correcta.
El proceso de inspeccin esta normado, existe un equipo de inspectores y una serie de pasos o
estndares y roles bien definidos que se deben cumplir. El resultado de una inspeccin indica si el trabajo
es aceptado o aprobado o re- trabajado bajo la supervisin del moderador o re-trabajado para una prxima
inspeccin.
Las revisiones tcnicas se encuentran dentro de los controles estticos manuales disciplinados.

Un equipo de inspeccin de Fagan consiste en: un asesor, un lector, un inspector, y un autor.

El asesor debe asegurarse de que la preparacin del equipo se centre en la deteccin de defectos sin
desviarse.
El papel del lector es explicar y leer el producto que es inspeccionado a un paso razonable, pues
el procedimiento se puede hacer de manera rpida, pero tal vez no se inspeccione lo que se desea.
El papel de un inspector es examinar el software desde el punto de vista de un usuario.
La presencia del autor en las reuniones de la inspeccin, generalmente se considera beneficiosa porque
puede asistir al equipo de la inspeccin para entender mejor el producto, adems est preparado para
entender la naturaleza de los defectos en los hallazgos del equipo.
Modelo de Fagn
Planificacin
Descripcin
Preparacin
Inspeccin
Remodelar
Seguimiento

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Historia del modelo

DEFINICIONES

Las inspecciones son revisiones de subproductos del proceso que se efectan durante todo el
ciclo de desarrollo de software. El objetivo de esta prctica es encontrar defectos en los productos sin
examinar porque surgieron ni cmo se resuelven. Los productos inspeccionados son componentes
pequeos que conforman una unidad funcional. Los productos tpicos son: especificacin de requisitos,
documentos de diseo, listado de cdigo, planes de testing, especificaciones de hardware, etc.

Imagen del modelo de proceso de programacin y el testeo segn Fagan fuente (Desing and code
inspections to reduce errors in program development by M.E Fagan)
El proceso de inspeccin fue definido originalmente por Fagan a principios de los aos 70's para
IBM, solo eran exmenes estrictos que se dirigan al cdigo fuente, actualmente estn dirigidas a los
procesos, metodologas, planes o a cualquier artefacto producido en el transcurso del desarrollo,
detectando algn defecto en estos.
Las inspecciones son fundamentales para el aseguramiento de la calidad pues establecen un
orden en el proceso al mismo tiempo que se establece una mejora continua. Son un proceso de mejora
incremental ya que a medida que pasa el tiempo en el desarrollo de software los defectos deben reducirse.
Objetivo de las inspecciones:
Encontrar tempranamente los defectos.
Prevenir el mal funcionamiento de los procesos o planes establecidos.
Proporcionar mejoras en la fiabilidad, disponibilidad y factibilidad del mantenimiento de software.
Descubrir continuamente la informacin tcnica, asociada con las funciones, formularios, actividades
internas que aseguran el producto.
Continuar el mejoramiento del proceso de desarrollo.
Establecer una igualdad de conocimiento dentro de los desarrolladores para la buena prctica de
estndares y tcnicas de desarrollo.

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Elaboracin Del Proceso

Figura del diagrama para el modelo de inspeccin segn la empresa.

En la empresa Villasoft el proceso de revisiones tcnicas se realizan siguiendo una serie de pasos
mostrados en el diagrama, no es muy diferente del modelo de Fagan comparten personajes y procesos
parecidos que se detallaran a continuacin.

Figura del diagrama para el modelo de inspeccin segn Fagan.

Nuestro proceso de inspeccin involucra una serie de etapas y roles que sern los participantes y sern
llevados a cabo durante el proceso.
Estos definen quienes se involucran en la inspeccin, que pasos se deben seguir y quien tomara cada rol
en cada paso de la inspeccin.
Producto a ser inspeccionado: El trmino producto es usado como producto intermedio o en
desarrollo, no se refiere al producto final que se entrega al cliente.
Los productos tienen aproximadamente de 10 a 20 pginas de pginas de tamao para los documentos y
de 200 a 250 lneas de cdigo.
Para que un producto est en condiciones de ser inspeccionado debe satisfacer criterios de entrada, entre
ellos: existencia de productos predecesores ya inspeccionados, respetar un formato estndar de
presentacin, y cumplir con chequeos automticos.

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Roles
Se identifican 4 roles principales, que pueden variar de modelo en modelo, este grupo esta conformado
por generalmente 4 a 6 personas.
La seleccin de inspectores est restringida a un grupo de desarrolladores que trabajan en componentes
similares o tienen algn tipo de interaccin con el producto. Los gerentes no deben participar, solo deben
monitorear el proceso de inspeccin.
1.-Moderador: es la persona que dirige la reunin de inspeccin, debe ser el inspector ms
experimentado. Este debe asegurar que el equipo est preparado, mantener el orden durante la reunin y
focalizar el proceso de inspeccin en los defectos. (Asesor)
2.-Registrador: es la persona que registra la localizacin y descripcin de los defectos encontrados.
(Inspector)
3.-Lector: es la persona que presenta el producto durante la reunin. Su propsito es centrar la atencin
del equipo en los detalles del material a ser inspeccionado. (Lector)
4.-Autor: es la persona que elabora el producto. No forma parte del equipo de inspeccin, su presencia
en la reunin permite aclarar posibles dudas y agilizar el tratamiento del producto en estudio. (Autor)
Proceso: Pasos
Planificacin: Se realiza la asignacin de roles a los inspectores. Las copias del producto y el material
relacionado son distribuidas. En esta etapa se planifica la reunin de inspeccin.
Conferencia introductoria (Orientacin inicial): Permite realizar una presentacin general del proyecto
en desarrollo a los inspectores que no estn familiarizados con el mismo, este paso es opcional.
Preparacin (Preparacin individual): Los inspectores se instruyen individualmente para la reunin de
inspeccin, estudiando el material aportado en la planificacin.
Reunin (Reunin de revisin): Los inspectores se renen para examinar el producto de software. El
lector presenta el trabajo mientras los dems investigan el producto en bsqueda de defectos, los cuales
son clasificados y registrados. Esta etapa de inspeccin no debe sobrepasar las 2 horas. Al final de la
reunin los inspectores deciden si el trabajo es aceptado, re trabajando bajo la supervisin del moderador
o re trabajando para una prxima inspeccin.
Re trabajo: El autor del trabajo corrige los errores encontrados en la reunin de inspeccin.
Seguimiento: Las correcciones realizadas por el autor son chequeadas por el moderador, si este queda
satisfecho las inspeccin queda oficialmente concluida.
Informes generados de la inspeccin
Informe resumen de la inspeccin: conclusiones breves de la inspeccin para la direccin: que se ha
revisado, quien la ha revisado, cual fue la conclusin.
Lista de acciones pendientes: Es un informe para los autores del producto revisado explicando que es lo
que est mal y si puede ser como corregirlo. Necesita ser claro, pero no muy elaborado. Es uno bebe
llegar a la direccin para informacin en prejuicio del proceso de inspeccin.
Informe de asuntos relacionados: Para registrar problemas que salen a la luz durante la inspeccin pero
no estn relacionados directamente con el objeto revisado, para que sean notificados a la persona
respnsale.
Informe del proceso de inspeccin: cuando algo ha salido mal en el proceso de inspeccin en si mismo.
Informe final: Para informar a la direccin del cierre de la inspeccin.

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

Apndice
5.1 Otros modelos de inspecciones
Modelo de Tom Gilb (1993)
Planeamiento y documentos de entrada. Planeamiento de la inspeccin, donde el lder
determina a los participantes de la dicha inspeccin, elabora las listas necesarias de la
documentacin, las reglas, los estndares y programa las reuniones.
Reunin rpida. El Jefe de Aseguramiento de Calidad organiza una rpida reunin donde l da
una escala de tiempo de realizacin para la inspeccin y otras instrucciones a los inspectores y al
autor, explica en trminos generales la estructura de la documentacin y el propsito de la
inspeccin.
Inspeccin o comprobacin. Es realizada por cada par individualmente, que registra cada defecto
en una tabla.
Registro. Cuando los inspectores han acabado la comprobacin en la fecha convenida el lder de
la inspeccin organiza la reunin de registro donde se mencionan todos los defectos y su
aceptacin o rechazo en el registro general de la inspeccin.
Tormenta de ideas. Una reunin de tormenta de ideas (5-30 minutos) sigue poco despus de la
reunin de registro. Donde se trata de dar solucin o ideas a los defectos encontrados para su
remodelacin.
Edicin. Se espera que el autor emprenda la accin de correccin.
Seguimiento. El lder de la inspeccin realiza un seguimiento a los cambios que debe realizar el
autor manteniendo un contacto con este.
Salida. Se entrega el producto y est listo para la salida de la inspeccin cuando todos los puntos
discutidos en la tormenta de ideas y el registro se han corregido y trabajado satisfactoriamente.
Modelo de Humphrey
Planificacin.
Descripcin.
Preparacin.
Anlisis.
Inspeccin.
Remodelar.
Seguimiento.

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

El siguiente cuadro describe los procesos de estas inspecciones, ya que ambas son muy parecidas y
contienen casi las mismas etapas en el proceso de inspeccin.

Proceso de revisiones tcnicas

Modelo de Fagan
Versin 1.0

[[Enzo Videla]]

Modelo de Humphrey
[[14-09-2015]]
(1976)
(1989)
Planificaci Cuando los materiales
Permite la seleccin de
n
para ser inspeccionados participantes y de la
pasan por los criterios de preparacin de los criterios
entrada (por ejemplo, el de la entrada.
cdigo fuente compila
con xito sin errores de
sintaxis), miembros del
equipo de inspeccin se
seleccionan, y se
establecen los horario de
la inspeccin (por
ejemplo, tiempo y lugar).
Descripci Se dan instrucciones
Se dan instrucciones
n
previas a los miembros previas a los miembros del
del equipo del material a equipo del material a ser
ser inspeccionado, y se inspeccionado, y se
asignan los papeles.
asignan los papeles.
Preparaci Los miembros del equipo Los inspectores detectan
n
estudian el material
los errores y registran en
individualmente para
una sola lista de registro.
prepararse para
satisfacer los papeles
asignados.
Inspeccin El equipo realiza una
En esta fase, el
reunin de inspeccin
desarrollador explica los
para encontrar defectos, defectos encontrados y los
y registrarlos. El
inspectores aclaran
propsito es la deteccin tambin, el por que de los
de los defectos o de
defectos. De esta forma se
violaciones de
establece una lista de
estndares, alternativas defectos que debe pasar a
debe ser eliminada por el la siguiente fase.
asesor.
Remodelar El autor revisa el
El autor revisa el resumen
resumen de los defectos de los defectos detectados,
detectados, clarificando clarificando cuales son
cuales son realmente
realmente defectos y que
defectos y que son mal son mal entendidos en el
entendidos en el proceso proceso de la inspeccin.
de la inspeccin.
Entonces, el autor debe
Entonces, el autor debe modificar para corregir los
modificar para corregir defectos.
los defectos.
Seguimien El asesor o el equipo
El asesor o el equipo entero
to
entero de inspeccin
de inspeccin repasa el
repasa el producto otra producto otra vez, para
vez, para asegurar que asegurar que todos los
todos los arreglos son
arreglos son eficaces y de
eficaces y de que no se que no se ha introducido
ha introducido ningn
ningn defecto adicional
defecto adicional durante durante la remodelacin.
la remodelacin.
Anlisis
No aplica
La lista de defectos o de
registro se pasa al autor
para que la analice y
10
verifique los defectos y se
prepare para la inspeccin.

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

5.2 Lista de estndares

En la siguiente tabla se entrega una lista de los estndares externos ms comunes:
rea de
Tpico
estandarizacin
Ciclo de vida del software Proceso del ciclo de vida
Gestin del proyecto
Desarrollo

Revisiones
Prueba

Calidad

Mtricas
Documentacin

Herramientas CASE
Plan de calidad
Especificacin de
requerimientos
Especificacin de diseo

Denominacin

Documentacin usuaria
SCM

Institucin
desarrolladora
IEEE
ISO /IEC
IEEE
DoD
IEEE
ISO
IEEE
NIST
IEEE
NIST
ISO/IEC
IEEE
AS
ISO
NCR
IEEE
IEEE
IEEE
IEEE/EIA
IEEE
ISO/IEC
IEEE
ISO/IEC
IEEE
IEEE
EIA

Identificador
del estndar
1074, 1074.1
12207
1058
498
1074
12207
1028, 1059
500-165
829, 1008, 1012,
1059
500-75, 500-165,
9126
1298
3563.1, 3563.2
9000 et al.
NUREG/CR-4640
982.1, 982.2, 1044,
1044.1, 1045, 1061
1175, 1209, 1343
730, 730.1
1498/IS 640
830
12207
1016, 1016.1
12207
1063
1042, 828
649

11

Proceso de revisiones tcnicas

Versin 1.0

[[Enzo Videla]]
[[14-09-2015]]

5.3. Conclusiones
La ventaja fundamental de las inspecciones es que permite mejorar la calidad del producto
alcanzando una alta tasa de deteccin y remocin de errores.
Como ventaja comparativa, las inspecciones facilitan la deteccin y remocin de defectos en etapas
tempranas del ciclo de vida de desarrollo del software, reduciendo costos de trabajo en relacin a
desarrollos de sistemas que solo hicieran testing para la deteccin de errores
El tiempo de testing lleva ms de un 40% en cualquier desarrollo de software. Un anlisis ms detallado
muestra que la mayor parte del tiempo dedicado al testing utiliza, efectivamente, en re trabajo
(corrigiendo los defectos encontrados en el testing). Las inspecciones minimizan el tiempo dedicado al re
trabajo del testing, ya que los defectos son solucionados en etapas tempranas disminuyendo drsticamente
el nmero de defectos a encontrar en etapas posteriores.
Una ventaja adicional de las inspecciones es la utilizacin de mtricas a partir de los datos registrados de
cada una de ellas. Estas mtricas permiten la mejora del proceso de inspeccin apropiadamente dicho,
como tambin la mejora del proceso de desarrollo de software en su conjunto.
Entre las mtricas ms destacadas encontramos:
Tasa promedio de preparacin para la inspeccin (mide el proceso de inspeccin)
Tasa promedio de inspeccin promedio (mide proceso de inspeccin)
Esfuerzo promedio de inspeccin por falla detectada (mide proceso de inspeccin)
Falla promedio de inspeccin por falla detectada por KLOC (mide proceso de desarrollo)
Efectividad de remocin de defectos (mide proceso de desarrollo)
Se puede observar que las inspecciones incrementan la calidad del software, ya que al ser introducidas al
proceso de desarrollo permiten encontrar defectos de cada fase, de tal manera que despus corregidos se
pasa a la fase siguiente sobre una base, en principio correcta o si hay defectos que no se detectaron en
etapas tempranas pueden capturarse en etapas posteriores.

12