Inglês para programadores
O inglês que se usa para trabalhar em tecnologia: da entrevista à daily de todo dia, 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
ramo de desenvolvimento separado da linha principal
Create a branch from main before you start the refactor.
Crie um ramo a partir da linha 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
registro de alteração salvo no histórico
Each commit should explain why the change was needed, not just what changed.
Cada registro de alteração deve explicar por que a mudança foi necessária, não só 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 de um ramo dentro de outro
We can merge as soon as two reviewers approve the change.
Podemos integrar assim que dois revisores aprovarem a alteração.
Verbo e substantivo com a mesma forma. Diga 'merge into main', nunca 'merge to main'.
pull request
pedido de revisão e integração de um ramo
I opened a pull request and tagged the two people who own that module.
Abri um 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 choque entre duas alterações no arquivo de configuração, então ninguém consegue integrar ainda.
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 seus registros sobre uma base mais nova
Please rebase on top of main so the history stays linear.
Por favor, reaplique seus registros sobre a linha principal para o histórico continuar 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 único registro de alteração de outro ramo
We had to cherry-pick that fix into the release branch.
Tivemos que trazer só aquela correção para o ramo da versão.
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 seu trabalho local de lado antes de trocar para o outro chamado.
Verbo e substantivo. 'Pop the stash' é trazer de volta o que foi guardado.
squash
juntar vários registros em um só
We squash everything into a single entry before integrating.
Juntamos tudo em um único registro antes de integrar.
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.
As diferenças estão grandes 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 outro ramo ou ponto do histórico
Do a checkout of the release branch to reproduce the problem.
Troque sua cópia local para o ramo da versão para 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 chamado, então vou corrigir o último registro.
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 endereço no servidor e envie o ramo 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 reaplicar seus registros sobre a linha principal e juntar tudo em um só 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.