1

Controles en el Desarrollo de SistemasM. en C. Mario Farías Elinos

Participantes:

María del Carmen Arredondo Vázquez

Rosa Ma. Castillejos Zermeño

REPORTE TÉCNICO

ISO/IEC TR 9294

TECNOLOGÍA DE LA INFORMACIÓN

Guías para la Administración de la Documentación de Software

2

Iniciación de un proyecto

Diseño

Desarrollo

Evaluación

Instalación

Modificación y Mejoras

Iniciación de la Documentación.

El papel de los Administradores

El Administrador se compromete con la organización al esfuerzo de documentación, dando soporte a las políticas, estándares, procedimientos, recursos y planes que ellos establecen

Evidencia del compromiso y apoyo de la administración descansa en 3 elementos

3

Elementos del papel del Administrador

1. El compromiso de la Administración hacia la documentación

Reconocer la documentación de software es importante y planearla, escribirla, revisarla, aprobarla, producirla distribuirla y mantenerse

2.- El soporte de la Administración hacia el compromiso del personal para con la documentación

Guías e incentivos para que el personal produzca la documentación requerida y la provisión de recursos para facilitar el trabajo

3.- Publicación de políticas sobre documentación• Estándares y guías

• Publicación de procedimientos para documentación

• Alojamiento de recursos adecuados para la documentación

• Planeación de la documentación como parte del proceso desarrollo sw.

Las funciones de la documentación de software

1. Comunicación con la administración

2. Comunicación de tarea-a-tarea

3. Control de calidad

4. Instrucción y referencia

5. Soporte de software

6. Referencia histórica

4

SCP

Inician elproyecto

Formulan losrequerimientos del

sistema

Desarrollan losdiseños de sistema

y programa

Producen ladocumentación enconformación con

las políticas yestándares

Diseñadores

Especialistas en

publicaciones

Especialistas en C.C.

Programadores de

mantenimiento

Especialistaen el áreatemática

Analista

Evaluan laintegridad general

del software

Mejoran el softwareoperacionay y

desarrollanmejoras o

extensiones

Comunicación de tarea-a-tarea

Establecimiento de una política de documentación

1. Sirven de guías para la toma de decisiones a todos los niveles

2. Deben publicarse políticas formales

3. Establecer disciplinas requeridas para la documentación efectiva del software

5

La documentación cubre el ciclo de vida completo del software

Documentación del Proyecto

Ciclo de Vida del S.I.

Modelo delProceso deDesarrollo

Metodologíautilizada en

el Desarrollo

Gestióndel Proyecto

Definición

Análisis

Diseño

Construcción

Prueba / Puesta a Punto

Arranque

Producción

La documentación cubre el ciclo de vida completo del software

6

1. La documentación debe administrarse

2. La documentación debe ser la apropiada dependiendo del tipo de lectores a quien esté destinada

3. El esfuerzo de documentación deberá estar integrado en el proceso general de desarrollo de software

4. Los estándares para la documentación deben identificarse y usarse

5. Deben especificarse las herramientas de apoyo a utilizar

Establecimiento de una política de documentación

Establecimiento de estándares y guías para la documentación

Deben adaptarse estándares y guías para:

1. El modelo de ciclo de vida del software

2. Los tipos de documentos y las inter-relaciones

3. Contenido de los documentos

4. Calidad de los documentos

5. Formatos de los documentos

6. Identificación de documentos

7

Se tienen que definir estándares para el nivel de calidad apropiado para diferentes tipos de documentos y diferentes tipos de proyecto.

Definición de la calidad de los documentos

Contenido

Estructura

Calidad en los documentos

Alcance

Claridad

Facilidad para que el lector

Apropiada para el tipo de proyecto

1

2

3

Definición de formatos de documentos.

•Control de calidad

•Legilibilidad

•Facilidad de mantenimiento

Consideraciones para la definición de formatos:

Importancia de estandarización

de los documentos:

• Tamaño y tipo del proyecto

• Lectores a quienes están destinados

• Número de etapas identificadas

• Presupuesto para documentación

• Si serán traducidos p/distribución internacional

8

Definición de un sistema de identificación de documentos.

Un medio estándar para identificar documentos es esencial para un control efectivo de la documentación.

del documento

publica el documento

documento

5. Autor

6. Autoridad aprobatoria

autor

Cuando los documentos sean producidos sin control estricto, cada página deberá ser identificada de manera única: no. referencia del documento, no. de página y no. de ejemplar.

Establecimiento de procedimientos para documentación.

Se deben establecer procedimientos para implementar las políticas y la secuencia de la documentación.

• Planeación• Preparación• Control de la configuración• Revisión• Aprobación• Producción• Almacenamiento• Respaldo• Distribución y actualización• Descontinuación

Métodos de Control

de Calidad

Puntos

de revis

ión

9

Recursos parala documentación.

•• SoftwareSoftware para el desarrollo•• Objetivo del softwareObjetivo del software para proporcionar información de la

aplicación a implementar•• Técnicas de documentación,Técnicas de documentación, importante que cada grupo

entienda y cumpla su papel en este proceso

Conocimientos requeridos del

PERSONAL

INSTALACIONES y RECURSOS DE

SOFTWARE

•• Adecuadas y apropiadas para la tarea de Adecuadas y apropiadas para la tarea de documentación.documentación.

•• Herramientas y recursos de Software para Herramientas y recursos de Software para la preparación y control de la la preparación y control de la documentación.documentación.

PRESUPUESTO

• Los costos de documentación deben ser identificados como elementos únicos en el presupuesto, ya que forman parte del desarrollo de software.

Planeación de la documentación.

Debe incluir actividades futuras y está sujeto a modificaciones conforme cambian las necesidades; se iniciará en una etapa temprana y será revisado en el transcurso del proyecto. Se distribuirá a todos los miembros del proyecto.

Establece lo que debe hacerse, cómo y cuándo debe hacerse y quién es el responsable.

®Planeación de los documentos®Revisión del plan de documentación y detalles®Preparación de muestras de documentos, y su revisión para determinar su precisión técnica, su alcance y calidad®Edición para incorporar los comentarios que surjan de las revisiones®Obtención de aprobaciones®Traducciones a otros idiomas®Distribución

®Estructura general de la documentación®Tipos y el contenido de los documentos®Calidad y los formatos de los documentos®Identificación de los documentos®Colección y almacenamiento de documentos®Distribución de documentos®Programación de la documentación (itinerario)

ITINERARIOESPECIFICACIONES

10

List

as d

e co

ntro

l par

a la

adm

inis

traci

ón d

e la

doc

umen

taci

ón d

elso

ftwar

e.1.

2.

3. Procedimientos

proyecto

Lista de control

adecuada?

Proporcionar recursos para la

Usar herramientas automatizadas para la

Modelo del ciclo de vida del software?

Tipos y contenido de documentos?

Niveles de calidad de los documentos?

Formatos para los documentos?

Almacenamiento de copias maestras y respaldos?

documentos, contenido, calidad, formatos,

presupuesto?

documentos?

Otorgamiento al personal de medios adecuados para funciones de

GLOSARIO

ISO:

Organización Internacional de Estándares (ISO por sus siglas en inglés)

IEC:

Comisión Internacional Electro-técnica (IEC por sus siglas en inglés)

TR:

Reporte Técnico (TR por sus siglas en inglés)

11

Referencias

ISO 2382:1984, Procesamiento de datos Vocabulario Parte 1: Términos fundamentales

ISO 6592:1985, Procesamiento de información – Guías para la documentación de sistemas basados en computadora

ISO 9127:1988, Sistemas de procesamiento de información – documentación para el usuario e información para paquetes de software comercial.