Cómo documentar la arquitectura

Para un proyecto relacionado con metodología de desarrollo que estoy llevando a cabo, estoy planteando la forma de documentar la arquitectura de las aplicaciones. Este es un reto interesante porque el tipo de arquitectura y las habilidades de los analistas y los proveedores son muy diferentes. Por un lado, algunos tienen un conocimiento bastante profundo del tema mientras que otros no le ven el sentido a este tipo de documento.

Dentro de las referencia que he revisado, creo haber encontrado un buen punto de partida, que aunque muy formal, se puede modificar para que sea práctico. La plantilla de word puede ser descargada de aquí.

Además, he estado revisando el documento clásico de Kruchten de Rational Rose: “The 4+1 View Model of Software Architecture”. El contenido es interesante en cuanto a concepto, pero creo que la técnica es bastante anticuada.

La nueva tendencia es documentar las vistas según se necesite y utiliza el concepto de punto de vista para evidenciar cómo la solución arquitectónica abordará las problemática que los clientes quieren solucionar.

Guía del Arquitecto

Tengo el proyecto de escribir un libro corto, y más que un libro corto, una guía para el arquitecto de software. El rol que debe ejecutar este persona es muy importante dentro de las organizaciones de TI y por ello se debe especificar de manera adecuada, no tanto las funciones, sino sus valores, su perfil y las habilidades que debe cultivar.

Con el fin de compartir la experiencia que tengo en el tema, especialmente para Colombia, voy a desarrollar la guía del arquitecto.

La idea fundamental es que el rol de arquitecto está por encima de la tecnología que utilice o prefiera, que son cosas distintas. El arquitecto utiliza ciertas tecnologías para lograr que los sistemas y la plataforma en general, solucione las necesidades de sus clientes.

Por lo tanto la guía será “agnóstica” en cuanto a tecnología, pero totalmente enfocada al rol como yo lo percibo.