There is a known issue with the date filter, but it does not block the user.
Há uma issue conhecida com o filtro de data, mas ela não bloqueia o usuário.Aula
Precisão lexical em tecnologia
Nível: B2
Objetivo
Escolher, com precisão lexical, entre pares e trincas de palavras próximas em tecnologia (issue vs problem, effective vs efficient, scalable vs extensible, robust vs resilient vs reliable) e evitar falsos cognatos com português (actually/currently, eventually/possibly, to pretend/to intend, to realize/to achieve, to attend/to assist, to push/to pull) em explicações técnicas, postmortems, RFCs e revisões de arquitetura.
Explicação
Em comunicação técnica, palavras que parecem sinônimos quase nunca são. A escolha entre issue e problem, ou entre effective e efficient, sinaliza maturidade: mostra que você entende a nuance e o impacto da palavra. Em B2, espera-se que você escolha o termo mais preciso em cada contexto — em um postmortem, em uma RFC, em uma conversa com stakeholders ou em uma retrospectiva.
Issue vs problem
Em geral, problem é mais grave: indica algo que bloqueia um objetivo, com impacto direto no usuário ou no negócio. Issue é mais neutro e muito usado em software: aparece em tickets, em 'known issues', em 'open issues', e pode ser algo pequeno ou um trabalho a fazer.
- `We need to fix the problem in checkout before the next release.` (algo crítico)
- `There is a known issue with the date filter, but it does not block the user.` (algo menor)
Em uma frase como 'no known issues' em um release notes, issue soa natural. 'No known problems' soa exagerado e raro.
Effective vs efficient
Effective significa 'que produz o efeito desejado' — cumpre o objetivo. Efficient significa 'que usa poucos recursos para produzir esse efeito' — faz com menos custo, menos tempo, menos memória.
- `The new caching layer is effective at reducing database load.` (cumpre o objetivo)
- `The new caching layer is efficient; it uses less memory and CPU.` (faz isso com menos recursos)
Um sistema pode ser effective sem ser efficient (faz a coisa certa, mas de forma cara) e efficient sem ser effective (faz rápido, mas a coisa errada). O ideal é ambos.
Scalable vs extensible
Scalable descreve um sistema que aguenta mais carga (mais usuários, mais requisições, mais dados) sem perder performance. Extensible descreve um sistema que aceita novas funcionalidades, integrações ou componentes sem precisar ser reescrito.
- `The service is horizontally scalable: we can add more instances under load.` (aguenta mais carga)
- `The plugin system is extensible: third parties can add new modules without forking the codebase.` (aceita extensões)
Um sistema pode ser scalable sem ser extensible (faz a mesma coisa melhor, em maior escala) ou extensible sem ser scalable (fácil de estender, mas quebra sob carga). As qualidades são independentes.
Robust, resilient, reliable
Esses três adjetivos costumam aparecer juntos, mas cada um cobre um ângulo diferente de qualidade.
- Robust = aguenta entradas ruins, cenários extremos, dados fora do padrão sem quebrar. `The parser is robust against malformed input.`
- Resilient = se recupera rápido de falhas. `The cluster is resilient: nodes can fail without downtime.`
- Reliable = funciona de forma consistente, sem falhar com frequência. `The notification service is reliable; we have not seen a missed alert in months.`
Robust lida com entradas ruins; resilient lida com falhas; reliable mede a frequência de falhas. Um sistema pode ser robust sem ser reliable (aguenta entradas ruins, mas cai às vezes) e reliable sem ser robust (não falha com frequência, mas quebra com entradas estranhas).
Falsos cognatos comuns em tecnologia
Falsos cognatos são palavras inglesas parecidas com palavras portuguesas, mas com significado diferente. Em tecnologia, alguns causam confusão frequente em e-mails, postmortems e reuniões.
- `actually` = na verdade (não 'atualmente'; 'atualmente' é currently)
- `eventually` = por fim, em algum momento (não 'eventualmente'; 'eventualmente' é possibly)
- `to pretend` = fingir (não 'pretender'; 'pretender' é to intend, to plan to)
- `to realize` = perceber, notar (não 'realizar'; 'realizar' é to carry out, to achieve)
- `sensible` = sensato, razoável (não 'sensível'; 'sensível' é sensitive)
- `to attend` = comparecer, participar (não 'atender'; 'atender' é to assist, to serve)
- `to push` = empurrar (não 'puxar'; 'puxar' é to pull)
Em um e-mail técnico, dizer `eventually, the system will fail` soa como 'o sistema pode vir a falhar' (possibly). Se você quer dizer 'por fim, em algum momento', use eventually. E dizer `actually, we are using version 3` confunde com 'atualmente'; o correto é `currently, we are using version 3` ou, se for para enfatizar, `actually, we are using version 3 (and not version 2)`.
Exemplos
| Inglês | Tradução | Observação |
|---|---|---|
| We need to fix the problem in checkout before the next release. | Precisamos corrigir o problema no checkout antes da próxima release. | Problem = algo crítico que bloqueia um objetivo. |
| There is a known issue with the date filter, but it does not block the user. | Há uma issue conhecida com o filtro de data, mas ela não bloqueia o usuário. | Issue = algo neutro, geralmente um trabalho a fazer. |
| The new caching layer is effective at reducing database load. | A nova camada de cache é eficaz em reduzir a carga do banco. | Effective = cumpre o objetivo (reduzir a carga). |
| The pipeline is efficient; it processes events in a single pass. | O pipeline é eficiente; ele processa os eventos em uma única passada. | Efficient = faz isso com menos recursos (single pass). |
| The service is horizontally scalable, so we can add more instances under load. | O serviço é escalável horizontalmente, então podemos adicionar mais instâncias sob carga. | Scalable = aguenta mais carga. |
| The plugin system is extensible, so third parties can add new payment providers. | O sistema de plugins é extensível, então terceiros podem adicionar novos provedores de pagamento. | Extensible = aceita novas funcionalidades sem reescrever. |
| The parser is robust against malformed input, and the cluster is resilient to node failures. | O parser é robusto contra entrada malformada, e o cluster é resiliente a falhas de nó. | Robust lida com entradas ruins; resilient lida com falhas. |
| Actually, the cache is already enabled; we just need to set the right TTL. | Na verdade, o cache já está ativado; só precisamos definir o TTL certo. | Actually = na verdade (não 'atualmente'). |
| Eventually, the cache filled up and latency returned to the previous level. | Por fim, o cache encheu e a latência voltou ao nível anterior. | Eventually = por fim, em algum momento (não 'eventualmente'). |
Erros comuns
- Usar 'problem' para qualquer coisa: em release notes e tickets, 'issue' é o termo padrão; reserve 'problem' para algo crítico.
- Trocar 'effective' por 'efficient' (ou vice-versa): a primeira pergunta a fazer é 'cumpre o objetivo?' (effective) ou 'usa poucos recursos?' (efficient).
- Dizer 'scalable' quando o que se quer dizer é 'extensible' (ou vice-versa): escalar é sobre carga; estender é sobre funcionalidades novas.
- Tratar 'robust', 'resilient' e 'reliable' como sinônimos: cada um cobre um ângulo (entradas ruins, recuperação, frequência de falhas).
- Traduzir 'atualmente' por 'actually': 'actually' significa 'na verdade'; para 'atualmente', use 'currently'.
- Traduzir 'eventualmente' por 'eventually': 'eventually' significa 'por fim'; para 'eventualmente' (possivelmente), use 'possibly' ou 'might'.
- Traduzir 'pretender' por 'pretend': 'pretend' é 'fingir'; 'pretender' é 'intend' ou 'plan to'.
- Traduzir 'realizar' por 'realize': 'realize' é 'perceber'; 'realizar' é 'achieve' ou 'carry out'.
- Traduzir 'atender' por 'attend': 'attend' é 'comparecer'; 'atender' é 'assist' ou 'serve'.
- Confundir 'push' e 'pull' em mensagens de commit e em UI: 'push' é empurrar/enviar; 'pull' é puxar/buscar.
Prática guiada
Escolha a palavra mais precisa para cada contexto:
- O checkout caiu por 22 minutos ontem. → problem (impacto direto no usuário, release em risco).
- O filtro de data mostra um dia a menos em alguns fusos horários. → issue (não bloqueia; pode entrar no backlog).
- O novo schema reduziu consultas redundantes. → effective (cumpre o objetivo de reduzir consultas).
- O novo schema faz isso sem migrar a tabela inteira. → efficient (faz com menos recursos/migração).
- O serviço aguenta 10x de tráfego sem intervenção. → scalable (aguenta mais carga).
- Parceiros podem adicionar novos provedores sem fork. → extensible (aceita novas funcionalidades).
- O parser não quebra com JSON inválido. → robust (aguenta entradas ruins).
- O cluster continua funcionando quando um nó cai. → resilient (se recupera de falhas).
- O serviço de notificação não perdeu alertas em meses. → reliable (funciona de forma consistente).
- 'Por fim, o sistema voltou ao normal.' → eventually (por fim, em algum momento).
Repare como cada palavra carrega um ângulo diferente: gravidade, objetivo, recursos, carga, funcionalidade, qualidade de entrada, recuperação, consistência.
Resumo
Use issue para itens de trabalho e bugs menores; reserve problem para algo crítico que bloqueia um objetivo. Effective cumpre o efeito; efficient usa menos recursos para isso. Scalable aguenta mais carga; extensible aceita novas funcionalidades. Robust aguenta entradas ruins; resilient se recupera de falhas; reliable falha pouco. Evite falsos cognatos: actually/currently, eventually/possibly, pretend/intend, realize/achieve, attend/assist, push/pull.
Vocabulário
Palavras principais
We need to fix the problem in checkout before the next release.
Precisamos corrigir o problema no checkout antes da próxima release.The new caching layer is effective at reducing database load.
A nova camada de cache é eficaz em reduzir a carga do banco.The pipeline is efficient; it processes events in a single pass.
O pipeline é eficiente; ele processa os eventos em uma única passada.The service is horizontally scalable; we can add more instances under load.
O serviço é escalável horizontalmente; podemos adicionar mais instâncias sob carga.The plugin system is extensible, so third parties can add new payment providers.
O sistema de plugins é extensível, então terceiros podem adicionar novos provedores de pagamento.The parser is robust against malformed input.
O parser é robusto contra entrada malformada.The cluster is resilient; nodes can fail without downtime.
O cluster é resiliente; nós podem falhar sem indisponibilidade.The notification service is reliable; we have not seen a missed alert in months.
O serviço de notificação é confiável; não vimos um alerta perdido em meses.Actually, the cache is already enabled; we just need to set the right TTL.
Na verdade, o cache já está ativado; só precisamos definir o TTL certo.Currently, we are using version 3 of the library.
Atualmente, estamos usando a versão 3 da biblioteca.Eventually, the cache filled up and latency returned to the previous level.
Por fim, o cache encheu e a latência voltou ao nível anterior.I pretended to understand the new schema during the review.
Eu fingi entender o novo schema durante a revisão.Only after the deploy did we realize the cache was misconfigured.
Só depois do deploy percebemos que o cache estava mal configurado.Bruno will attend the architecture review on Tuesday.
Bruno vai participar da revisão de arquitetura na terça-feira.A sensible next step is to add automated load tests before the redesign.
Um próximo passo sensato é adicionar testes de carga automatizados antes do redesign.We intend to ship the redesign in the next quarter.
Pretendemos lançar o redesign no próximo trimestre.The team achieved zero downtime during Black Friday.
O time alcançou zero indisponibilidade durante a Black Friday.História
História: Precisão lexical em tecnologia
Nível: B2
História em inglês
The outage
Last Friday, the checkout service went down for 22 minutes during peak hours. The on-call engineer, Bruno, filed a postmortem and listed three open items. One of them was a real problem: a misconfigured connection pool had caused the outage. The other two were minor issues: a date format in the receipt, and a tooltip that did not show on Firefox. The team agreed to fix the problem first and to track the issues in the backlog.
The redesign
On Monday, the team opened an RFC for the checkout redesign. The new architecture is horizontally scalable; we can add more instances under load. The plugin layer is also extensible, so third-party providers can add new payment methods without forking the codebase. The team wants the service to be robust against malformed payloads and resilient to downstream failures. If the redesign holds up, the notifications service will be more reliable, with fewer missed alerts.
A small confusion
During the review, Bruno said, 'Eventually, we should add a circuit breaker between checkout and the payment provider.' Pedro asked, 'Do you mean we should add it at some point, or that we might add it?' Bruno laughed and said, 'I mean at some point. We cannot assume the downstream will be reliable forever.' A second engineer added, 'Actually, we already have a circuit breaker in the fraud service. We intend to reuse it.' The team agreed: a sensible next step is to extract that module and to document the decision in the RFC. Bruno will attend the architecture committee on Tuesday to defend the proposal.
Tradução linha por linha
| Inglês | Tradução |
|---|---|
| Last Friday, the checkout service went down for 22 minutes during peak hours. | Na sexta passada, o serviço de checkout caiu por 22 minutos no horário de pico. |
| The on-call engineer, Bruno, filed a postmortem and listed three open items. | O engenheiro de plantão, Bruno, abriu um postmortem e listou três itens em aberto. |
| One of them was a real problem: a misconfigured connection pool had caused the outage. | Um deles era um problem de verdade: um pool de conexões mal configurado tinha causado a indisponibilidade. |
| The other two were minor issues: a date format in the receipt, and a tooltip that did not show on Firefox. | Os outros dois eram issues menores: um formato de data no recibo e um tooltip que não aparecia no Firefox. |
| The team agreed to fix the problem first and to track the issues in the backlog. | O time concordou em corrigir o problem primeiro e em registrar as issues no backlog. |
| On Monday, the team opened an RFC for the checkout redesign. | Na segunda, o time abriu uma RFC para o redesign do checkout. |
| The new architecture is horizontally scalable; we can add more instances under load. | A nova arquitetura é horizontally scalable; podemos adicionar mais instâncias sob carga. |
| The plugin layer is also extensible, so third-party providers can add new payment methods without forking the codebase. | A camada de plugins também é extensible, então provedores terceiros podem adicionar novos métodos de pagamento sem fazer fork do código. |
| The team wants the service to be robust against malformed payloads and resilient to downstream failures. | O time quer que o serviço seja robust contra payloads malformados e resilient a falhas a jusante. |
| If the redesign holds up, the notifications service will be more reliable, with fewer missed alerts. | Se o redesign se sustentar, o serviço de notificações ficará mais reliable, com menos alertas perdidos. |
| During the review, Bruno said, 'Eventually, we should add a circuit breaker between checkout and the payment provider.' | Durante a revisão, Bruno disse: 'Eventually, a gente devia adicionar um circuit breaker entre o checkout e o provedor de pagamento.' |
| Pedro asked, 'Do you mean we should add it at some point, or that we might add it?' | Pedro perguntou: 'Você quer dizer que a gente devia adicionar em algum momento, ou que talvez a gente adicione?' |
| Bruno laughed and said, 'I mean at some point. We cannot assume the downstream will be reliable forever.' | Bruno riu e disse: 'Quero dizer em algum momento. A gente não pode assume que o serviço a jusante vai ser reliable para sempre.' |
| A second engineer added, 'Actually, we already have a circuit breaker in the fraud service. We intend to reuse it.' | Um segundo engenheiro acrescentou: 'Actually, a gente já tem um circuit breaker no serviço de fraude. A gente intend reutilizar.' |
| The team agreed: a sensible next step is to extract that module and to document the decision in the RFC. | O time concordou: um sensible próximo passo é extrair esse módulo e documentar a decisão na RFC. |
| Bruno will attend the architecture committee on Tuesday to defend the proposal. | Bruno vai attend o comitê de arquitetura na terça para defender a proposta. |
Notas de vocabulário
- problem = Reservado para o incidente crítico: a causa-raiz (connection pool) que derrubou o checkout.
- issues = Itens menores do backlog: data no recibo e tooltip do Firefox; nada disso bloqueia o usuário.
- horizontally scalable = Escala horizontal: adicionar mais instâncias em vez de aumentar a máquina; é o que o redesign habilita.
- extensible = A camada de plugins aceita novos métodos de pagamento sem fork; sobre funcionalidade, não carga.
- robust = Tratar payloads malformados de forma previsível; rejeitar com 400 em vez de 500.
- resilient = Absorver falhas a jusante (provedor lento) sem derrubar o serviço.
- reliable = Consistência no tempo: a meta é reduzir alertas perdidos, não apenas tratar entradas ruins.
- eventually = Por fim, em algum momento; diferente de 'eventualmente' (possivelmente). Pedro pediu para esclarecer.
- assume = Supor: 'a gente não pode supor que o downstream será confiável para sempre'.
- actually = Na verdade: o segundo engenheiro corrigiu uma impressão ('já temos um circuit breaker').
- intend = Pretender (ter a intenção de): 'pretendemos reutilizar o módulo de fraude'.
- sensible = Sensato, razoável: a decisão de extrair e documentar é prudente, não 'sensível'.
- attend = Comparecer: Bruno vai participar do comitê na terça; não é 'atender' (servir).
Perguntas de compreensão
- What was the real problem that caused the outage?
- How many issues did the team list in the postmortem, and which were minor?
- Why is the new architecture described as horizontally scalable?
- What does the team mean by saying the plugin layer is extensible?
- How do 'robust' and 'resilient' differ in the redesign description?
- Why did Pedro ask Bruno to clarify 'eventually'?
- What did the second engineer point out with 'actually'?
- What is the 'sensible next step' the team agreed on?
- When will Bruno attend the architecture committee, and for what?
Prática com a história
- Reescreva com precisão: 'We need to fix a problem in the date filter.' (issue ou problem?)
- Reescreva com 'effective' ou 'efficient': 'The new cache uses less memory and still reduces database load.'
- Reescreva com 'eventually' (por fim) ou 'possibly' (eventualmente): 'In the end, the cache filled up.'
- Corrija: 'Actually, we are using version 3 of the library.' (atualmente)
- Reescreva com 'intend': 'We pretend to extract the circuit breaker module in the next sprint.'
- Reescreva com 'attend' ou 'assist': 'Bruno will attend the customer during the outage.'
Prática
Exercícios e teste
A próxima melhoria é transformar esses arquivos em perguntas com resposta no navegador. Por enquanto, esta página já organiza o estudo e permite seguir a aula inteira sem abrir os arquivos manualmente.