UML Domine el lenguaje de modelado más utilizado en la actualidad

G eneración a u tom á tic a de d o c um e n ta c ió n Por lo tanto, no es posible que el generador obtenga información si no la hemos espe­ cificado nosotros anteriormente de alguna manera. Es nuestra responsabilidad mane­ jar la documentación correctamente como uno de los objetos más valiosos de nuestro proyecto, y que ésta se encuentre correctamente plasmada en nuestros modelos. Como es común que los modelos vayan cambiando y evolucionando continua­ mente, es importante tener actualizada la documentación. Una heurística razona­ ble en diversos procesos de software es generar la documentación durante algiin período regular. Por ejemplo, cada lunes o los últimos viernes del mes. También esta documentación es útil a la hora de las clásicas reuniones generales del grupo encargado del desarrollo para comunicar eficazmente los avances y planificar futu­ ras modificaciones o correcciones. Documentación automática en Visual Paradigm En toda entidad de nuestros modelos dentro de Visual Paradigm podemos acceder a una región específica para la documentación dentro del área Abrir Especificación. Por ejemplo, en la documentación de la clase Radio del ejemplo anterior, podríamos agregar la fecha de codificación y el programador responsable, junto con una des­ cripción general de la clase, como podemos ver en la siguiente figura. Limitaciones Diagramas Referencias Comentarios Anotariones Java jj Consulta ORM (l^lapeo Relacional de Objetos) il Estereotipos II Valores Etiquetados General Attributes 1| Operations 1 Relaciones ¡I Template Parameters | Class Code Details Nombre; Radio Padre; Visibilidad: público Documentación; HTML B / U . = -= = F F F # f f H Û- Una radio may simple qua se prendey se apaga Autor: Lorenzo! Fecha: 20/12/2009 Q Abstracto Q Hoja Q Rafe Q Activo Q Modelo de negocio Restablecer OK Cancelar Aplicar Ayuda F igu ra 8. Información adicional que luego será incorporada en la documenfac/ón. Cuando generamos código automáticamente, la herramienta nos agrega como comentarios en el lenguaje destino la información que hemos transmitido en la parte de documentación de nuestros modelos. Esta es una característica sumamen- 239