Guia · Devlingo

Mensagem de commit em inglês: como escrever e exemplos

Resposta rápida

Commit em inglês se escreve no imperativo, como uma ordem: “Add login screen”, não “Added” nem “Adding”. A linha de título fica curta, por volta de 50 caracteres, e o corpo explica o porquê. O primeiro commit costuma ser “Initial commit”. O Devlingo, do Gambit Studio, treina o inglês de PR e documentação.

Atualizado em 2 min de leituraGambit Studio

Usar sem baixar →Grátis no navegador, sem cadastro

A regra do imperativo

A mensagem completa a frase If applied, this commit will...: ...add login screen, ...fix null pointer in checkout. Por isso o verbo vai no imperativo e sem ponto final. O título deve caber em cerca de 50 caracteres e, se precisar de mais, uma linha em branco separa o corpo.

Verbos mais usados

VerboQuando usarExemplo
Addalgo novoAdd search filters
Fixcorreção de bugFix crash on empty cart
Updatemudança em algo existenteUpdate README setup steps
RemoveapagarRemove unused imports
Refactorreorganizar sem mudar comportamentoRefactor payment service
RenamerenomearRename user_id to account_id
Bumpsubir versão de dependênciaBump axios to 1.7.2
Revertdesfazer commitRevert "Add search filters"
ImprovemelhoriaImprove error messages
Movemudar de lugarMove helpers to utils

Conventional Commits

Muitos times usam o padrão type: description: feat: (funcionalidade), fix: (correção), docs:, refactor:, test:, chore: (manutenção). Exemplos:

CommitO que diz
feat: add dark mode togglenova funcionalidade: botão de modo escuro
fix: handle empty response from APIcorreção: tratar resposta vazia da API
docs: update install instructionsdocumentação: atualizar instruções de instalação
refactor: extract date helpersrefatoração: extrair funções de data
test: add unit tests for parsertestes: adicionar testes do parser
chore: bump dependenciesmanutenção: atualizar dependências

Erros comuns de brasileiro

EvitePrefiraPor quê
Added loginAdd login screenimperativo e mais específico
Fixing bugFix crash when cart is emptydiga qual bug
ChangesUpdate API timeout to 30smensagem genérica não ajuda ninguém
Correction of the error in the paymentFix payment rounding errorcurto e direto

Commit em inglês ou português? Se o time ou o projeto é internacional, ou o código é aberto, em inglês. Mais frases para PR em pull request em inglês.

Como treinar estas frases

Escolha três frases, adapte ao seu caso e fale em voz alta antes da próxima reunião. O Devlingo, do Gambit Studio, tem mais de 3.600 frases de trabalho em tecnologia, separadas por situação, com 10 frases novas por dia, pronúncia e exemplos de uso, e um widget com a frase do dia na Tela de Início.

Perguntas frequentes

O que mais perguntam sobre o assunto, respondido com a fonte.

Como escrever commit em inglês?
No imperativo (Add, Fix, Update), com título curto de cerca de 50 caracteres e sem ponto final.
Como escrever o primeiro commit em inglês?
Initial commit é o padrão.
Commit em inglês ou português?
Siga o padrão do repositório. Em time internacional ou projeto aberto, em inglês.
O que significa commit em inglês?
Como verbo, comprometer-se ou confirmar. No Git, é salvar um conjunto de mudanças no histórico.
DevlingoFrases técnicas e fluência
Usar sem baixarBaixar