Paapiro / conteúdo de exemplo
Caderno de decisões
Um conceito de registro leve para documentar o motivo de uma escolha técnica.
Projeto fictício de exemplo. Não há aplicação, repositório ou resultados disponíveis.
A ideia
Um caderno versionado para registrar contexto, alternativas e consequências de decisões técnicas. O foco do conceito é permitir que uma pessoa entenda por que uma escolha foi feita.
O experimento proposto
Criar um modelo Markdown com quatro campos: pergunta, contexto, decisão e pontos a revisitar. Aplicar o modelo a uma decisão hipotética e revisar se ele preserva o raciocínio.
O que seria avaliado
Clareza do registro, facilidade de atualização e utilidade para alguém que não participou da conversa original. Nenhuma dessas avaliações foi realizada neste exemplo.