Não utilizar números nos títulos
Contexto e Declaração do Problema
Como renderizar a primeira linha de uma ADR?
As ADRs precisam possuir um identificador único, porém existe a decisão sobre expor ou não esse identificador diretamente no título.
Opções Consideradas
- Usar apenas o título
- Adicionar o número da ADR antes do título (por exemplo: “# 2. Não utilizar números nos títulos”)
Decisão
Opção escolhida: “Usar apenas o título”, porque:
- Essa prática é comum em outros arquivos Markdown. A numeração não costuma ser adicionada manualmente no conteúdo, ficando sob responsabilidade do framework de renderização ou do CSS.
- Facilita a renomeação das ADRs antes da publicação, sem necessidade de ajustes adicionais.
- Permite copiar e colar ADRs entre diferentes repositórios sem preocupações com conflitos ou inconsistências de numeração.