Implementar um registro de alterações

  • 3 minutos

Um changelog é simples: é um arquivo que lista as alterações feitas em um projeto, geralmente organizadas por data. O formato típico mostra as versões e, para cada versão, lista:

  • Recursos adicionados – Coisas novas que você pode fazer
  • Recursos modificados/aprimorados – itens que funcionam melhor
  • Recursos excluídos – Itens que foram removidos

Algumas equipes postam changelogs como postagens no blog. Outros criam um arquivo CHANGELOG.md em seu repositório GitHub.

Ferramentas de changelog automatizadas

Embora você possa criar e manter os changelogs manualmente, convém usar uma ferramenta automatizada para ajudá-lo. Pelo menos como ponto de partida.

Usando comandos nativos do Git

O git log comando pode ajudá-lo a criar conteúdo automaticamente. Por exemplo, crie uma nova seção por versão:

git log [options] vX.X.X..vX.X.Y | helper-script > projectchangelogs/X.X.Y

Registro de alterações do Git

Uma ferramenta popular é o gitchangelog. Essa ferramenta é escrita em Python.

Gerador de changelog do GitHub

Outra ferramenta popular é chamada github-changelog-generator.

$ github_changelog_generator -u github-changelog-generator -p TimerTrend-3.0

Essa ferramenta é baseada no Ruby Gem.

Você deve usar dados baseados em log gerados automaticamente?

Geralmente, é melhor evitar apenas copiar entradas de log em um log de alterações. Os logs contêm muitos detalhes técnicos, portanto, é fácil criar uma bagunça confusa que não ajude os usuários a entender o que mudou.