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 Bogotá

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

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

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

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

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

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

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

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

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

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

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

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

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

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