Introducción
La evidencia de blogs de ABAP sugiere que los desarrolladores se comunican con su audiencia utilizando
-
Mucho texto (técnico),
-
Bloques de código (ABAP),
-
Algunas capturas de pantalla (anotadas),
-
Pocas imágenes,
-
Pocos o ningún diagrama.
Para la mayoría de nosotros, un diagrama es más fácil de entender que un texto. Cada tipo de diagrama comunica la intención de una manera especial. Ayuda a razonar sobre el software y facilita la transferencia de conocimientos. Se crearon muchas notaciones dispares que tuvieron que ser estandarizadas.
Hoy en día, el
Lenguaje Unificado de Modelado
(
UML
) es una notación establecida para visualizar diseños utilizando los siguientes tipos de diagramas:
Elementos Esenciales de UML
Para decidir qué tipo de diagrama comunica mejor nuestra intención, debemos comprender sus características esenciales. Destacaré
-
Especificaciones de requisitos: podríamos querer visualizar los requisitos en un diagrama de casos de uso (también consultar: diagramas de actividad, diagramas de estado)
-
Elementos de modularización: queremos proporcionar una vista general de la estructura del código utilizando diagramas de clases (diagramas de objetos, diagrama de estructura compuesta)
-
El comportamiento dinámico del código: queremos enfatizar interfaces en un diagrama de secuencia. (o diagrama de temporización)
y consultar algunos tutoriales, por ejemplo
Cómo Crear Diagramas
Crea un
boceto aproximado
en papel a mano, captura la imagen con un teléfono/cámara y súbela.
Vale, tengo que trabajar en mis habilidades y hacer preprocesamiento de imágenes, pero esto es probablemente tan fácil como crear una captura de pantalla anotada.
Sin herramientas adecuadas, crear diagramas (por ejemplo, como este)
llevaría demasiado tiempo, veríamos código fuente copiado/pegado en la documentación. Hay muchas
herramientas
disponibles, algunas gratuitas (busca en la web por
herramientas UML gratuitas
), otras con un precio y plantillas fáciles de usar. Propongo seleccionar una y acostumbrarse a ella, para que el esfuerzo necesario para crear esos diagramas se reduzca.
Prueba PlantUML
Permíteme presentarte la herramienta de código abierto
PlantUML
que crea
diagramas UML
a partir de texto plano
. Utiliza el software de visualización de gráficos
Pedro Pascal
Se unió el 07/03/2018