Inglês para ler documentação

1. Ler é a primeira habilidade

A documentação oficial das ferramentas, as mensagens de erro, as respostas em fóruns e as notas de versão quase sempre saem primeiro em inglês. Às vezes, só existem em inglês. Ler bem já resolve a maior parte do que você vai precisar no começo da carreira.

Leitura técnica é mais fácil do que parece. O texto é direto, repete as mesmas estruturas e usa um vocabulário limitado. Com estratégia e um glossário pessoal, em poucas semanas você lê uma página de documentação sem traduzir tudo.

2. Você já sabe mais do que imagina

Cognatos são palavras parecidas nas duas línguas, com o mesmo sentido. Em textos técnicos, eles aparecem o tempo todo:

Repare nos finais: -tion costuma virar -ção, -ly costuma virar -mente, -ble costuma virar -vel. Muitos termos técnicos, como software, backup, login e deploy, já são usados em inglês no dia a dia de TI no Brasil.

3. Falsos cognatos que confundem em TI

Algumas palavras parecem conhecidas, mas significam outra coisa. Estas aparecem muito em documentação:

4. Ler em camadas: passar o olho, achar, aprofundar

Ninguém lê documentação de cima a baixo, palavra por palavra. Leia em três camadas:

1. Passar o olho (skimming): leia só o título, os subtítulos, os blocos de código e o que estiver em destaque. Em um minuto, você sabe do que a página trata e se ela serve.
2. Achar (scanning): procure a informação que você precisa. Use Ctrl+F (Cmd+F no Mac) com a palavra-chave: o nome do comando, da opção ou do erro.
3. Aprofundar: leia com atenção só o trecho que importa. Aqui vale parar nas palavras novas e anotar.

Os blocos de código ajudam muito: eles mostram o que fazer mesmo quando o texto em volta parece difícil.

5. Como uma documentação é organizada

A maioria das documentações segue o mesmo desenho. Saber onde cada coisa fica economiza tempo:

Também repare nas caixas Note (observação), Tip (dica), Warning e Caution (cuidado) e Important. As de aviso costumam dizer o que pode quebrar algo.

Documentações usam muito o imperativo: Run (rode), Install (instale), Make sure (garanta que), Replace (substitua). Quando aparece algo como <your-name> ou YOUR_API_KEY, é um lugar para você trocar pelo seu valor.

6. Ler mensagens de erro

Mensagens de erro parecem assustadoras, mas costumam dizer exatamente o que aconteceu. Leia com calma, procurando três coisas: o que falhou, onde e por quê.

cp: cannot stat 'relatorio.txt': No such file or directory

O programa cp não conseguiu ler (cannot stat) o arquivo relatorio.txt porque não existe arquivo ou pasta com esse nome (No such file or directory). Provavelmente você está na pasta errada ou digitou o nome errado.

Traceback (most recent call last):
  File "gastos.py", line 3, in <module>
    total = total + valor
NameError: name 'total' is not defined

Em Python, a linha mais importante é a última: NameError, o nome total não foi definido (is not defined). As linhas acima dizem onde: no arquivo gastos.py, linha 3. A variável foi usada antes de receber um valor.

7. As palavras que mais aparecem

Comece seu glossário com estas. Elas aparecem em erros, logs (os registros do que um programa fez) e documentação de quase toda ferramenta:

Monte o seu num arquivo de texto ou num aplicativo de flashcards, com três colunas: a palavra, o sentido e a frase onde você a encontrou. A frase ajuda a lembrar.

8. Tradutor e IA: apoio, não muleta

• Leia primeiro, traduza depois. Tente entender o parágrafo sozinho e use o tradutor para confirmar. Assim você treina, em vez de só consumir a tradução.
• Não traduza código nem comandos. Tradutores às vezes traduzem nomes de comandos e opções, e o comando para de funcionar. Copie sempre o código da página original.
• Peça à IA a explicação, não só a tradução. Por exemplo: "Explique em português o que este parágrafo da documentação quer dizer e destaque os termos técnicos". Confira o que ela disser no texto original.
• Desconfie de páginas traduzidas automaticamente. Elas ajudam, mas podem ter erros em termos técnicos. Na dúvida, compare com a versão em inglês.

9. Um hábito de 15 minutos por dia

• Leia uma página de documentação da ferramenta que você está estudando, em camadas.
• Anote de três a cinco palavras novas no glossário, com a frase de exemplo.
• Deixe o celular ou um aplicativo que você usa muito em inglês por uma semana.
• Quando estiver mais confortável, assista a vídeos técnicos com legenda em inglês, não em português.

Falar e ouvir vêm depois e também importam, principalmente para vagas em empresas de fora. Mas ler bem já abre muitas portas.