O que é um changelog?
Um changelog é um registro cronológico e legível por humanos das mudanças notáveis feitas em cada versão de um projeto.
Quando você atualiza uma ferramenta e quer saber o que mudou, você olha o changelog dela. É o histórico corrente de um projeto contado em termos que usuários se importam, novas features, correções e breaking changes, organizado por release.
O que ele registra
Um changelog lista as mudanças significativas em cada versão: o que foi adicionado, o que mudou, o que foi descontinuado, o que foi removido e o que foi corrigido. Ele é escrito para humanos, em linguagem simples, focando no impacto das mudanças em vez dos detalhes de implementação que um log de commits mostraria.
Como é organizado
As entradas são agrupadas por versão e data, mais recentes primeiro, frequentemente com subseções como Adicionado, Alterado, Corrigido e Removido. Essa estrutura permite ao leitor pular para uma versão específica ou escanear o release mais recente de relance. Breaking changes são tipicamente destacadas de forma proeminente.
Um exemplo
## [2.1.0] - 2026-06-26
### Added
- Dark mode toggle in settings
### Fixed
- Crash when opening empty projectsPor que usuários dependem dele
Um changelog responde à pergunta da atualização: é seguro, e vale a pena? Ele diz aos usuários se um release corrige um bug que eles enfrentaram, adiciona algo que querem, ou contém uma breaking change para planejar. Sem ele, toda atualização é uma aposta, então um changelog claro constrói confiança.
Automatizando isso
Manter um changelog à mão é fácil de esquecer. Muitos times o geram automaticamente a partir de mensagens de commit estruturadas ou títulos de pull request como parte do pipeline de release. Combinado com versionamento semântico, isso produz release notes precisas sem nenhum passo manual.
Principais conclusões
- Um changelog é um histórico legível, por versão, de mudanças notáveis.
- Ele é agrupado por release com categorias como adicionado e corrigido.
- Ele ajuda usuários a decidir se e como atualizar.