Skip to content

Instantly share code, notes, and snippets.

@jandersonTIC
Forked from joshbuchea/semantic-commit-messages.md
Last active February 24, 2023 14:49
Show Gist options
  • Star 4 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save jandersonTIC/316845110c3e52be3288e218101e3225 to your computer and use it in GitHub Desktop.
Save jandersonTIC/316845110c3e52be3288e218101e3225 to your computer and use it in GitHub Desktop.
Melhorar a semântica das mensagens de commit no Git

Boas práticas para mensagens de commit no Git

Veja como pequenas alterações nas mensagens de commit no Git podem ajudar você e seu time a melhorar a legibilidade e rastreabilidade do seu código.

Formato:

<tipo>[escopo opcional]: <descrição>

[corpo opcional]

[rodapé opcional]

rodapé é opcional, mas eu recomendo quando estiver usando Jira, porque o Jira consegue rastrear e relacionar Jira Issues com commit, branch e pull request, desde que você esteja usando a chave do Jira Issue como footer.

Exemplo

fix: correct minor typos in code

see the issue for details
on typos fixed.

JIRAISSUEKEY-123

Co-authored-by: Fulana Silva <fulana.silva@gmail.com>
Co-authored-by: Beltrano Costa <beltrano.costa@hotmail.com>

Outra convenção importante é inserir tipos no título do commit, seja alguns tipos e seus respectivos propósitos:

  • feat: (nova funcionalidade para o usuário, não use quando a funcionalidade não tiver relação com o usuário, por exemplo, criar um script de build)
  • fix: (corrigir um bug para o usuário, não usar para correção de bugs que não aferam o usuário)
  • docs: (alterações em documentações)
  • style: (formatação, lint, esqueçeu um ponto de vírgula, etc; sem alteração de código de produção)
  • refactor: (refatoração de código de produção, por exemplo, renomear uma variável)
  • test: (adicionar testes, refatorar testes; sem alteração de código de produção)
  • chore: (atualização de tarefas de rotina; sem alteração de código de produção)

Saiba mais em:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment