Conselhos de trabalho em equipe para ADRs

Se você está pensando em usar registros de decisão com sua equipe, aqui estão alguns conselhos que aprendemos trabalhando com muitas equipes.

Você tem a oportunidade de liderar seus colegas conversando juntos sobre o “porquê”, em vez de impor o “quê”. Por exemplo, registros de decisão são uma forma de as equipes pensarem de modo mais inteligente e se comunicarem melhor; registros de decisão não têm valor se forem apenas uma exigência burocrática imposta após o fato.

Algumas equipes preferem muito mais o nome “decisões” (decisions) à abreviação “ADRs”. Quando algumas equipes usam o nome de diretório “decisions”, é como se uma lâmpada se acendesse, e a equipe começa a colocar mais informações no diretório, como decisões de fornecedores, decisões de planejamento, decisões de cronograma etc. Todos esses tipos de informação podem usar o mesmo modelo. Nossa hipótese é que as pessoas aprendem mais rápido com palavras (“decisões”) do que com abreviações (“ADRs”), que as pessoas ficam mais motivadas a escrever documentos em andamento quando a palavra “registro” é removida e que alguns desenvolvedores e alguns gerentes não gostam da palavra “arquitetura”.

Em teoria, a imutabilidade é ideal. Na prática, a mutabilidade funcionou melhor para as nossas equipes. Inserimos a nova informação no ADR existente, com um carimbo de data e uma nota de que a informação chegou depois da decisão. Esse tipo de abordagem leva a um “documento vivo” que todos nós podemos atualizar. Atualizações típicas ocorrem quando recebemos informações graças a novos colegas, novas ofertas, resultados reais dos nossos usos ou mudanças de terceiros posteriores à decisão, como capacidades de fornecedores, planos de preços, contratos de licença etc.