Architectural Decision Records
Introducción
¡Bienvenidos al blog!
En la entrada de hoy hablaremos sobre los registros de decisiones arquitectónicas. Es un documento que captura una decisión arquitectónica tomada junto con su contexto y consecuencias.
Cómo comenzar a usar ADR con herramientas
Puedes comenzar a usar ADR con varias herramientas. Si te gusta usar Google Drive y la edición en línea, puedes crear un documento de Google. Si desea utilizar el control de versiones del código fuente, como git, puedes crear un archivo para cada ADR. Si te gusta utilizar herramientas de planificación de proyectos, como Atlassian Jira, puedes utilizar el rastreador de planificación de esa misma herramienta. Si te gusta usar wikis, como MediaWiki, puedes crear un wiki de ADR.
Pero, ¿cuándo debería escribir uno?
Podrías estar pensando: "Es exactamente lo que mi equipo necesita para facilitar la toma de decisiones mientras realiza un seguimiento de las decisiones de futuros compañeros de equipo. Pero, ¿cuándo debería escribir uno?Es exactamente lo que mi equipo necesita para facilitar la toma de decisiones mientras realiza un seguimiento de las decisiones de futuros compañeros de equipo. Pero, ¿cuándo debería escribir uno?Es exactamente lo que mi equipo necesita para facilitar la toma de
decisiones, pero ¿cuándo debería escribir uno?".
Se debe redactar un ADR siempre que se tome una decisión de impacto significativo.
Beneficios
Los futuros miembros del equipo pueden leer un historial de decisiones y ponerse al día rápidamente sobre cómo y por qué se toma una decisión, y el impacto de esa decisión.
Los nuevos propietarios de un sistema pueden ponerse al día rápidamente sobre cómo y por qué la arquitectura del sistema evolucionó de la forma en que lo hizo simplemente leyendo los ADR.
Plantillas de ejemplo de ADR
Puedes usar algunos de los ejemplos como base para escribir un ADR
- Plantilla ADR de Michael Nygard (simple y popular)
- Plantilla ADR de Jeff Tyree y Art Akerman (más sofisticado)
- Plantilla ADR para patrón Alejandrino (simple con detalles de contexto)
- Plantilla ADR para caso de negocios (más orientada a un enfoque administrativo, con costos, FODA y más opiniones)
- Plantilla ADR MADR (más Markdown)
- Plantilla ADR usando Planguage (más orientado al aseguramiento de la calidad)
Conclusión
Como has podido comprobar según leías este blog, los ADR son una herramienta de trabajo muy interesante que puede ayudar a todos los stakeholder incluidos en el proyecto, incluyendo a aquellos que acaban de unirse al equipo, tanto a miembros como a propietarios del sistema.
Si te ha parecido interesante, desde aquí te animamos a que en el próximo proyecto que realices, escribas también un ADR.
¡Puedes usar una de las plantillas de la sección anterior!
Referencias
https://github.com/joelparkerhenderson/architecture_decision_record
https://engineering.atspotify.com/2020/04/14/when-should-i-write-an-architecture-decision-record/
Comentarios
Publicar un comentario