Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Preguntas frecuentes

¿Cuáles son los beneficios de crear un proceso de ADR?

El equipo del proyecto debe crear un proceso de ADR para optimizar la toma de decisiones de arquitectura, evitar discusiones repetidas sobre los mismos temas en cuanto a la arquitectura y comunicar las decisiones de arquitectura de manera eficaz.

¿Cuándo debe crear un ADR el equipo del proyecto?

El equipo del proyecto debe crear un ADR para cada aspecto del software que afecte a la estructura (patrones como los microservicios), los requisitos no funcionales (seguridad, alta disponibilidad y tolerancia a fallas), las dependencias (acoplamiento de componentes), las interfaces (APIsy los contratos publicados) y las técnicas de construcción (bibliotecas, marcos, herramientas y procesos).

¿Con qué frecuencia debe revisar un ADR el equipo del proyecto?

El equipo del proyecto debe revisar el ADR al menos una vez antes de aceptarlo.

¿Quién debe crear un ADR?

Todos los miembros del equipo pueden crear un ADR. Le recomendamos que promueva el concepto de propiedad para. ADRs El autor propietario del ADR debe mantener y comunicar el contenido del ADR de forma activa. Otros miembros del equipo siempre pueden contribuir a un ADR. El propietario del ADR debe aprobar los cambios en un ADR.

¿Qué información debe contener un ADR?

Como mínimo, cada ADR tiene que definir el contexto de la decisión, la decisión en sí, y las consecuencias de la decisión para el proyecto y sus resultados. El contexto debe mencionar las posibles soluciones que consideró el equipo. También debe contener cualquier información pertinente relacionada con el proyecto, el cliente o el conjunto de tecnologías. La decisión debe indicar de forma clara, en un lenguaje imperativo, la solución que el equipo ha decidido adoptar. Evite utilizar palabras como “debería” y redacte cada decisión de la siguiente manera: “Utilizamos...” o “El equipo tiene que utilizar...”. En la sección de consecuencias se deben mencionar todas las desventajas conocidas que conlleva tomar la decisión. Cada ADR debe tener un estado y un registro de cambios que contenga la fecha del cambio y la persona responsable del cambio.

¿Dónde puedo encontrar las plantillas de ADR?

Hay varias versiones y variantes de las plantillas de ADR disponibles. Para ver una colección pública de plantillas de ADR de uso común, consulte el GitHub repositorio de ADR.