Changelog¶
O N45 mantém um changelog do seu projeto automaticamente. Você não escreve ele à mão — toda mudança entregue gera uma entrada, e a versão é calculada pelo próprio N45.
Onde vive¶
.n45/docs/CHANGELOG.md — gerenciado pelo N45, no formato Keep a Changelog.
Como as entradas são criadas¶
| Fluxo | O que acontece |
|---|---|
| Caminho rápido (Hot Fix / Quick Feat) | Ao confirmar que a mudança funcionou, o N45 adiciona uma entrada na seção Unreleased (ainda sem número de versão) |
| Roadmap estruturado | Ao fechar o roadmap, o N45 gera a entrada e calcula a versão automaticamente a partir da versão anterior + o conteúdo |
Versionamento automático (semver)¶
Quando o N45 versiona uma entrada, o tipo de bump vem das seções dela:
| Seção na entrada | Bump | Exemplo |
|---|---|---|
### Breaking |
major | 1.4.2 → 2.0.0 |
### Adicionado |
minor | 1.4.2 → 1.5.0 |
Demais (ex.: ### Corrigido) |
patch | 1.4.2 → 1.4.3 |
Gerenciado pelo N45
Como os documentos fundamentais, o CHANGELOG.md é gerenciado pelo N45 — edições manuais serão sobrescritas. Pra registrar uma mudança, use os fluxos (/n45-feat, /n45-fix); a entrada nasce do trabalho entregue.