Liderança: processo ADR
Este curso trata de Registros de Decisão de Arquitetura (ADRs), usando um repositório Rails como exemplo do começo ao fim. Começa pelas decisões que existem só num documento de regras ou no histórico do git, sem o raciocínio junto. Depois define o que é um ADR: curto, imutável, numerado, sobre uma decisão e escrito na hora. As aulas mostram como escrever um ADR completo, escolher quais decisões merecem registro, substituir em vez de editar e ligar os ADRs ao documento de regras. A última aula escreve um ADR em trinta minutos.
O que você vai aprender
- ✓Por que um documento de regras e o histórico do git não registram decisões
- ✓O formato do ADR: contexto, decisão, consequências e alternativas
- ✓Escrever a consequência de que você não gosta e nomear a condição de validade
- ✓Filtrar quais decisões merecem um ADR
- ✓Substituir um ADR aceito sem editá-lo
- ✓Ligar ADRs e o documento de regras nos dois sentidos
As decisões sem registro
Este repositório tem dois documentos que parecem registrar decisões, e nenhum dos dois registra.
Ler a aula completa grátis →Currículo
7 aulasAs decisões sem registro
Mostra como o MEMORY.md e o histórico do git deixam sem raciocínio quatro decisões desta aplicação.
O que é um ADR
Define o ADR como curto, imutável, numerado e sobre uma decisão, com seu formato e ciclo de status.
Escrevendo um
Escreve por inteiro o ADR de rodar o código de quem estuda no navegador e analisa cada seção.
O que registrar
Usa uma pergunta, se alguém precisaria rederivar a decisão, para escolher o que merece um ADR.
Substituindo, nunca editando
Explica por que uma decisão alterada ganha um ADR substituto enquanto o registro antigo fica sem edição.
ADRs e o documento de regras
Separa o documento de regras, no presente, dos ADRs, no passado, e mostra como ligar os dois.
Juntando tudo: trinta minutos
Escreve o ADR da Pagy em trinta minutos, revisa os hábitos e adota a citação como medida.