As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Perguntas frequentes

Quais são os benefícios da criação de um processo de ADR?

A equipe do projeto deve criar um processo de ADR para simplificar a tomada de decisões arquitetônicas, evitar discussões repetidas sobre os mesmos tópicos arquitetônicos e comunicar decisões arquitetônicas de forma eficaz.

Quando a equipe do projeto deve criar um ADR?

A equipe do projeto deve criar um ADR para cada aspecto do software que afeta a estrutura (padrões como microsserviços), requisitos não funcionais (segurança, alta disponibilidade e tolerância a falhas), dependências (acoplamento de componentes), interfaces (APIse contratos publicados) e técnicas de construção (bibliotecas, estruturas, ferramentas e processos).

Com que frequência a equipe do projeto deve revisar um ADR?

A equipe do projeto deve revisar o ADR pelo menos uma vez antes de aceitá-lo.

Quem deve criar um ADR?

Cada membro da equipe pode criar um ADR. Recomendamos que você promova uma noção de propriedade para ADRs. Um autor proprietário de um ADR deve manter e comunicar ativamente o conteúdo do ADR. Outros membros da equipe sempre podem contribuir para um ADR. O proprietário do ADR deve aprovar as alterações em um ADR.

Quais informações um ADR deve conter?

No mínimo, cada ADR deve definir o contexto da decisão, a decisão em si e as consequências da decisão para o projeto e seus resultados. O contexto deve mencionar as possíveis soluções consideradas pela equipe. Ele também deve conter todas as informações relevantes relacionadas ao projeto, ao cliente ou ao conjunto de tecnologias. A decisão deve indicar claramente, em linguagem imperativa, a solução que a equipe decidiu adotar. Evite usar palavras como “deveria” e expresse cada decisão como “Usamos...” ou “A equipe tem que usar...”. A seção de consequências deve mencionar todas as vantagens e desvantagens conhecidas de tomar a decisão. Cada ADR deve ter um status e um changelog que contenha a data da alteração e a pessoa responsável pela alteração.

Onde posso encontrar modelos de ADR?

Há várias versões e variantes de modelos de ADR disponíveis. Para obter uma coleção pública de modelos de ADR comumente usados, consulte o repositório ADR. GitHub