“Architecture Decision Records irá salvá-lo de adivinhar. Você já trabalhou em uma base de código e se perguntou por que estava usando uma determinada biblioteca/framework, aplicando um padrão ou implantando de uma maneira específica? Se você perguntar a um colega de equipe e ele também não tiver ideia, porque isso também foi definido antes dele. A decisão ainda é relevante para o contexto atual? Qual era o contexto quando a decisão foi tomada? Muito disso é conhecimento institucional que se perde, deixando você na dúvida. Em vez disso, capture registros de decisão de arquitetura junto com seu código no mesmo repositório. É um registro de todas as decisões tomadas ao longo de um projeto/produto.”
- Architecture Decision Records (ADR) as a LOG that answers “WHY?”
- When Should I Write an Architecture Decision Record – Spotify Engineering
- Lightweight Architecture Decision Records | Technology Radar | ThoughtWorks
Modelo proposto de uma ADR:
# 1. Initial project architecture
Date: YYYY-MM-dd
## Status
Accepted
## Context
The issue motivating this decision, and any context that influences or constrains the decision.
## Decision
The change that we're proposing or have agreed to implement.
## Consequences
What becomes easier or more difficult to do and any risks introduced by the change that will need to be mitigated.