Inglês para programadores
O inglês usado no trabalho em tecnologia: da entrevista à daily, do code review ao Slack. Cada item traz tradução, exemplo e uma nota sobre quando usar. Toque no alto-falante para ouvir a pronúncia.
Crie uma conta para treinar com repetição espaçada e acompanhar o que já domina.
branch
linha de desenvolvimento separada da principal
Create a branch from main before you start the refactor.
Crie uma linha separada a partir da principal antes de começar a refatoração.
Pronuncia-se 'brântch'. Os verbos que andam junto são to create, to check out e to push a branch. 'To cut' existe, mas quase sempre ligado a release: to cut a release branch.
commit
alteração registrada no histórico do repositório
Each commit should explain why the change was needed, not just what changed.
Cada alteração registrada deve explicar por que a mudança foi necessária, não apenas o que mudou.
Serve como verbo e substantivo. Em inglês corporativo, 'to commit to a deadline' é comprometer-se com um prazo.
merge
integração das alterações de uma branch em outra
We can merge as soon as two reviewers approve the change.
Podemos combinar as alterações assim que dois revisores aprovarem.
Verbo e substantivo com a mesma forma. Diga 'merge into main', nunca 'merge to main'.
pull request
pedido para revisar e integrar as alterações de uma branch
I opened a pull request and tagged the two people who own that module.
Abri o pedido de revisão e marquei as duas pessoas responsáveis por aquele módulo.
O verbo é to raise ou to open, nunca to make. No GitLab o nome equivalente é merge request.
merge conflict
choque entre duas alterações na mesma parte do código
There is a merge conflict in the settings file, so nobody can integrate yet.
Há um conflito de merge no arquivo de configuração, então ainda não dá para fazer o merge.
O verbo certo é to resolve a conflict, não to solve. Em call, 'I'm resolving conflicts' explica o atraso da revisão.
rebase
reaplicar as alterações registradas sobre uma base mais nova
Please rebase on top of main so the history stays linear.
Por favor, reaplique suas alterações sobre a linha principal para manter o histórico linear.
Substantivo e verbo têm a mesma forma. Nunca reescreva histórico já compartilhado sem avisar o time.
revert
desfazer uma alteração criando outra que a anula
The safest move was to revert that change and reopen the discussion tomorrow.
O movimento mais seguro foi desfazer aquela alteração e reabrir a discussão amanhã.
Desfaz uma alteração pontual. Para voltar o ambiente inteiro à versão anterior o time diz roll back.
cherry-pick
trazer um commit específico de outra branch
We had to cherry-pick that fix into the release branch.
Tivemos que trazer apenas aquela correção para a branch da release.
Escreve com hífen e funciona como verbo. Fora do código, 'to cherry-pick data' é escolher só o que favorece seu argumento.
stash
guardar alterações locais de lado sem registrá-las
Stash your local work before switching to the other ticket.
Guarde temporariamente suas alterações locais antes de trocar para o outro ticket.
Verbo e substantivo. 'Pop the stash' é trazer de volta o que foi guardado.
squash
juntar vários commits em um só
We squash everything into a single commit before merging.
Juntamos tudo em um único commit antes de fazer o merge.
Pronuncia-se 'skuóch'. 'Squash and merge' é o botão padrão em muitos repositórios.
diff
conjunto de diferenças entre duas versões do código
The diff is too big to review in one sitting.
O conjunto de alterações está grande demais para revisar de uma vez só.
Vem de difference, mas no dia a dia é substantivo próprio: 'send me the diff'.
fork
cópia independente de um repositório sob a sua conta
Contributors work on a fork and send the changes back to the original project.
Quem contribui de fora trabalha em uma cópia própria e devolve as alterações para o projeto original.
Também é verbo. Em conversa de time, 'let's fork the conversation' significa abrir uma discussão paralela.
upstream
o repositório ou serviço original do qual você depende
Pull from upstream every morning to avoid painful conflicts.
Traga as alterações do projeto original toda manhã para evitar conflitos dolorosos.
Também descreve dependência entre sistemas: 'the upstream service is down' é o serviço do qual o seu depende.
checkout
troca da cópia local para outra branch ou ponto do histórico
A checkout of the release branch let us reproduce the problem.
Trocar para a branch da release nos permitiu reproduzir o problema.
Substantivo escreve junto (a checkout), verbo escreve separado (to check out). Erro escrito clássico de brasileiro.
tag
marca fixa em um ponto do histórico, usada para nomear versões
Every version we publish gets a tag so we can find it later.
Toda versão que publicamos recebe uma marca fixa para acharmos depois.
Cuidado com o outro sentido: 'to tag someone' em um chamado é mencionar a pessoa, não etiquetar.
blame
visão que mostra quem alterou cada linha e quando
Run blame on that line to find out which change introduced it.
Veja o histórico linha a linha para descobrir qual alteração trouxe isso.
O nome assusta, mas o uso é investigativo. Em time saudável se diz 'let's check the history', não 'who broke it'.
amend
corrigir o último registro em vez de criar outro
I forgot the ticket number, so I will amend the last entry.
Esqueci o número do ticket, então vou corrigir a última alteração registrada.
Verbo formal, também usado em contratos ('to amend the agreement'). No git, só é seguro fazer amend em registro que ainda não foi compartilhado — depois do push, editar a história é o mesmo problema do rebase malfeito.
remote
endereço do repositório hospedado no servidor
Add the new remote and push the branch there.
Adicione o novo repositório remoto e faça push da branch para lá.
Mesma palavra usada para trabalho a distância ('a remote role'). O contexto separa os dois sentidos.
working tree
os arquivos como estão agora na sua máquina
Your working tree is dirty, so the script refuses to run.
Seus arquivos locais têm alterações pendentes, então o script se recusa a rodar.
'Dirty' aqui significa com alterações ainda não registradas, sem nenhum julgamento de qualidade.
Can you rebase on main and squash the commits before I review?
Você pode fazer rebase na main e juntar os commits com squash antes de eu revisar?
Pedido padrão em revisão de código. Muitos times exigem histórico limpo antes de aceitar a integração.
20 itens neste tópico.
Cada guia explica a situação inteira — o roteiro, o que se espera de você e os erros típicos de quem fala português.