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.
draft
rascunho, ainda não pronto para revisão
I opened it as a draft while I wait for the API contract.
Abri o PR como rascunho enquanto espero o contrato da API.
Abrir assim sinaliza 'ainda não revise, mas veja a direção'. Evita que alguém revise linha a linha um código que você ainda vai reescrever.
request changes
pedir formalmente alterações antes de aprovar o PR
I'll request changes on this one because the migration has no rollback path.
Vou pedir alterações neste PR porque a migration não tem um caminho de rollback.
É o botão do GitHub; quando o repositório exige aprovação (regra de proteção de branch), ele trava a integração até você revisar de novo. Como soa duro, explique o motivo no primeiro comentário e volte rápido depois do ajuste.
reviewer
pessoa designada para revisar o código de alguém
Can you add someone from the infra team as a second reviewer?
Você pode adicionar alguém do time de infraestrutura como segundo revisor?
Anda com os verbos add, assign e request: you assign a reviewer, you request a review. Quem escreveu o código é o author, nunca o owner.
walkthrough
explicação passo a passo
I added a short walkthrough in the description to speed up review.
Coloquei uma explicação passo a passo na descrição para acelerar a revisão.
Descrição boa economiza horas de revisão: diga o que mudou, por que mudou e por onde começar a ler.
force-push
reenviar a branch por cima, reescrevendo o histórico já publicado
I had to force-push after cleaning up the history, so pull the branch again before you review.
Tive que reenviar por cima depois de limpar o histórico, então baixe a branch de novo antes de revisar.
Avise no comentário antes de fazer: quem já revisou perde os comentários ancorados nas linhas antigas. Só se faz na própria branch, nunca na main.
self-review
ler o próprio diff antes de entregar para os colegas
I always do a self-review before I mark the pull request as ready.
Sempre releio o meu próprio código antes de marcar a solicitação como pronta.
Deixe comentários seus apontando as decisões duvidosas: economiza uma rodada inteira. Em avaliação de desempenho a mesma palavra é autoavaliação, o contexto decide.
stacked PR
PR aberto sobre outro PR que ainda não recebeu merge
This is a stacked PR on top of the schema change, so review that one first.
Esta é uma solicitação encadeada em cima da mudança de esquema, então revise aquela primeiro.
Comum em times que exigem revisões pequenas. Diga sempre qual é a base, senão o revisor vê o diff acumulado e acha que você mexeu em muito mais coisa.
PR description
texto de abertura que explica o que muda e por quê
A good PR description says what changed and why; it does not repeat the diff.
Um bom texto de abertura diz o que mudou e por quê, não repete o diff linha a linha.
É o que o revisor lê antes do código e o que sobra no histórico do repositório. Comece pelo motivo, depois pelo que você testou. Esse campo é lido por muita gente.
This PR adds retry logic to the payment webhook and a test for the timeout case.
Este PR adiciona lógica de retry ao webhook de pagamento e um teste para o caso de timeout.
Comece a descrição pelo que a mudança faz, no presente simples. Não escreva 'This PR is for adding' nem conte a história da investigação: o revisor quer o resumo primeiro.
Ready for review whenever you have a moment.
Pronto para revisão quando você tiver um tempo.
Aviso padrão ao tirar o esboço. Sem essa frase, muita gente não percebe que o código deixou de ser rascunho e virou pedido de revisão de verdade.
I've addressed all the comments, could you take another look?
Resolvi todos os comentários, você poderia dar mais uma olhada?
'Address a comment' é o verbo certo para resolver um comentário. Peça a nova olhada explicitamente, porque nem toda ferramenta avisa o revisor.
Good point, I've updated it in the latest commit.
Boa observação, já ajustei no último commit.
Resposta curta e sem defensiva. Concordar rápido quando o revisor está certo acelera a revisão e melhora sua reputação no time.
Thanks for the thorough review, this is much better now.
Obrigado pela revisão detalhada, ficou bem melhor agora.
Agradecer revisão detalhada custa dez segundos e é o que faz a pessoa querer revisar seu código de novo na próxima vez.
I'd rather keep this change small and handle the rest separately.
Prefiro manter esta mudança pequena e tratar o resto à parte.
'I'd rather' é a maneira suave de recusar. Combine com uma promessa concreta do que vem depois, senão soa como fuga.
I'm splitting this into two smaller pull requests to make review easier.
Vou dividir isso em duas solicitações menores para facilitar a revisão.
Mudança gigante trava a revisão por dias. Anunciar a divisão evita que alguém comece a revisar um código que vai desaparecer.
Sorry for the big diff, most of it is generated code.
Desculpa pelo diff grande, a maior parte é código gerado automaticamente.
Explicar o tamanho antes de alguém abrir evita a reação automática de deixar a revisão para depois.
I left the old method in place for one release to avoid breaking clients.
Mantive o método antigo por uma versão para não quebrar quem consome.
Descrever a estratégia de compatibilidade na descrição já responde a pergunta que todo revisor experiente faria.
Could someone from the platform team take a look at this one?
Alguém do time de plataforma poderia dar uma olhada nesta aqui?
Pedido aberto a um time funciona melhor do que marcar cinco pessoas: marcação em massa faz cada um assumir que outro vai responder.
18 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.