1 e-Genesis – El generador de sistemas Propuesta de auto-documentación Conferencia sobre una propuesta de auto-documentación de software Manuel Dávila Sguerra Ingeniero de sistemas de la Universidad de los Andes Maestría en Filosofía de la Universidad Javeriana Decano de la Facultad de Ingeniería de Uniminuto [email protected] Bogotá

2 Introducción La necesidad de la documentación técnica del software Mantenimiento Soporte Corrección de errores Despersonalización del código e-Genesis – El generador de sistemas Propuesta de autodocumentación

3 e-Genesis – El generador de sistemas Propuesta de autodocumentación El problema Usualmente se hace durante el ciclo de desarrollo Durante la etapa de producción se descuida Se hacen cambios al software más no a la documentación Si se mantiene esta disciplina es fácil caer en errores Se crea desconfianza lo que encarece el mantenimiento porque se recurre al código fuente Dificulta la estandarización

4 DIA DIA es un programa desarrollado bajo el Framework de desarrollo GTK+ Liberado bajo la licencia GPL Inspirado en el programa comercial VISIO Permite dibujar diagramas de diversas clases: UML, diagramas de flujo, diagramas de redes etc. Permite relacionar los objetos Permite especificaciones en XML Maneja múltiples formatos: EPS, SVG, XFIG, WMF, PNG y muchos más e-Genesis – El generador de sistemas Propuesta de autodocumentación

5 Tecnologías involucradas Lenguaje: perl Expresiones regulares: regesp Servidor de web: Apache Lenguaje de marcas: html Lenguaje especificaciones: xml Software gráfico: DIA Formatos: shape, png e-Genesis – El generador de sistemas Propuesta de autodocumentación

6 e-Genesis – El generador de sistemas Propuesta de autodocumentación Un diagrama de Redes usando DIA

7 e-Genesis – El generador de sistemas Propuesta de autodocumentación Diagrama de UML – Clases usando DIA

8 e-Genesis – El generador de sistemas Propuesta de autodocumentación Un diagrama de Clases con propiedades usando DIA

9 e-Genesis – El generador de sistemas Propuesta de autodocumentación Un diagrama de Clases con comentarios usando DIA

10 e-Genesis – El generador de sistemas Propuesta de autodocumentación Un diagrama de Actividades usando DIA

11 e-Genesis – El generador de sistemas Propuesta de autodocumentación Diagrama de UML – Actividad usando DIA

12 e-Genesis – El generador de sistemas Propuesta de autodocumentación Diagrama de UML- Caso de uso usando DIA

13 e-Genesis – El generador de sistemas Propuesta de autodocumentación La propuesta

14 Formatos shape mascara-dia mascara-atributos mascara-operaciones mascara-objetos e-Genesis – El generador de sistemas Propuesta de autodocumentación

15 Programas Cross-references Autodocumentar e-Genesis – El generador de sistemas Propuesta de autodocumentación