Architecture Decision Record

Active theme: Light

← documentos

Como começar a usar ADRs

Para começar a usar ADRs, converse com seus colegas de equipe sobre estas áreas.

Identificação da decisão:

  • Quão urgente e quão importante é o AD?

  • Ele precisa ser tomado agora ou pode esperar até que se saiba mais?

  • Tanto a experiência pessoal e coletiva quanto métodos e práticas de design reconhecidos podem ajudar na identificação de decisões.

  • Idealmente, mantenha uma lista de decisões a tomar que complemente a lista de tarefas do produto.

Tomada de decisão:

  • Existem várias técnicas de tomada de decisão, tanto gerais quanto específicas de arquitetura de software, por exemplo, o mapeamento de diálogo.

  • A tomada de decisão em grupo é um tópico de pesquisa ativo.

Promulgação e aplicação da decisão:

  • Os ADs são usados no design de software; portanto, precisam ser comunicados e aceitos pelas partes interessadas do sistema que o financiam, desenvolvem e operam.

  • Estilos de codificação arquiteturalmente evidentes e revisões de código que se concentram em preocupações e decisões arquiteturais são duas práticas relacionadas.

  • Os ADs também precisam ser (re)considerados ao modernizar um sistema de software na evolução do software.

Compartilhamento da decisão (opcional):

  • Muitos ADs se repetem entre projetos.

  • Portanto, as experiências com decisões passadas, boas e ruins, podem ser ativos reutilizáveis valiosos ao empregar uma estratégia explícita de gestão do conhecimento.

Documentação da decisão:

  • Existem muitos modelos e ferramentas para captura de decisões.

  • Veja as comunidades ágeis, por exemplo, os ADRs de M. Nygard.

  • Veja os processos tradicionais de engenharia de software e design de arquitetura, por exemplo, os layouts de tabela sugeridos pela IBM UMF e por Tyree e Akerman, da CapitalOne.

Para saber mais: