O que é changelog? Guia com exemplos práticos
Se você esbarrou com a palavra "changelog" e ficou na dúvida do que ela significa, a resposta curta vem primeiro, os detalhes logo abaixo.
O que é um changelog?
Um changelog (em português, "registro de mudanças") é uma lista, organizada por data ou versão, de tudo que mudou num produto de software: o que foi adicionado, o que mudou, o que foi corrigido e o que foi removido. Pense nele como o diário de bordo do seu produto, só que escrito para quem usa ele, não para quem programa.
Cada entrada costuma ter três partes: uma data (ou um número de versão, tipo v2.4.0), um tipo de mudança (novidade, correção, alteração) e uma descrição curta do que aconteceu.
Para que serve um changelog?
Um produto de software está sempre mudando. O problema é que, na maioria das vezes, essas mudanças acontecem em silêncio: o time faz o deploy e ninguém avisa ninguém. O changelog resolve isso, e traz uns ganhos concretos:
- O usuário descobre o que é novo sem precisar caçar. Aquela funcionalidade que você suou pra construir finalmente é vista.
- Cai o volume de suporte. "Por que mudou X?" costuma já estar respondido no changelog.
- Passa a sensação de produto vivo. Um changelog atualizado mostra que a casa está trabalhando, o que gera confiança (e ajuda a segurar cancelamentos).
- Vira referência interna. Vendas, suporte e sucesso do cliente param de perguntar "o que entrou no último release?".
Changelog não é o histórico do Git
Essa é a confusão mais comum. O git log lista commits — mensagens técnicas, escritas por e para desenvolvedores, tipo fix: null check on export handler. Isso não é changelog.
O changelog é curado e escrito para o usuário final. Em vez de "null check on export handler", ele diz "Corrigimos um erro que impedia a exportação de alguns relatórios". Um é registro técnico bruto; o outro é comunicação.
Os tipos de mudança
Existe uma convenção bem aceita (a do Keep a Changelog) que agrupa as mudanças em categorias. Você não precisa usar todas, mas ajuda a manter consistência:
| Tipo | Quando usar |
|---|---|
| Adicionado | Uma funcionalidade nova que não existia. |
| Modificado | Algo que já existia e mudou de comportamento. |
| Corrigido | Um bug que foi consertado. |
| Descontinuado | Algo que ainda funciona, mas vai sair em breve. |
| Removido | Algo que foi retirado do produto. |
Um exemplo de changelog
Na prática, uma entrada bem escrita fica assim:
v3.1.0 — 1 de julho de 2026
- Adicionado: exportação de relatórios em CSV, além do PDF.
- Modificado: o endpoint de exportação agora exige um token de API.
- Corrigido: o filtro por data no dashboard ignorava o fuso horário.
Repare: nada de jargão, cada linha começa pelo que o usuário ganha, e dá pra ler em dez segundos.
Como começar o seu
Não complique. Um bom changelog é mais sobre constância do que sobre ferramenta:
- Escreva para o usuário, não para o time técnico. Comece pelo benefício.
- Publique onde ele vai ver — dentro do próprio produto é o ideal, não perdido num arquivo no repositório.
- Mantenha o ritmo. Um changelog abandonado passa a impressão contrária da que você quer.
É exatamente aí que o Nowledge ajuda: você escreve a novidade num painel e ela aparece dentro do seu produto por um widget, além de virar uma página pública. Se quiser ver funcionando, dá pra começar de graça, sem cartão.