Controles en el Desarrollo de Sistemasmario.elinos.org.mx/docencia/ctrldesa/expo-iso9294.pdf ·...
Transcript of Controles en el Desarrollo de Sistemasmario.elinos.org.mx/docencia/ctrldesa/expo-iso9294.pdf ·...
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.