Read the overview first.
Leia a visão geral primeiro.Aula
Leitura de documentação básica
Nível: A1
Objetivo
Reconhecer partes comuns de documentação em inglês e encontrar comandos rapidamente usando leitura por varredura.
Explicação
Documentação técnica costuma ter títulos, listas e blocos de comandos. No A1, você não precisa entender cada palavra. Procure palavras-chave:
- `Overview` = visão geral
- `Requirements` = requisitos
- `Installation` = instalação
- `Usage` = uso
- `Warning` = aviso importante
- `Note` = nota ou observação
Para achar comandos, procure linhas com palavras como `npm`, `git`, `run`, `install` ou símbolos como `$`.
Exemplos
| Inglês | Tradução | Observação |
|---|---|---|
| Overview | Visão geral | Normalmente explica o projeto. |
| Requirements | Requisitos | Lista o que você precisa antes. |
| Installation | Instalação | Mostra passos para instalar. |
| Usage | Uso | Mostra como usar. |
| Warning: Do not commit secrets. | Aviso: não faça commit de segredos. | `Warning` merece atenção. |
| Note: This command is slow. | Nota: este comando é lento. | `Note` adiciona informação útil. |
Erros comuns
- Não leia a documentação inteira quando a tarefa é achar um comando. Faça `skim`: passe os olhos procurando termos.
- Não ignore `Warning`; geralmente indica risco.
- Não confunda `requirements` com pedidos informais. Em documentação, são requisitos necessários.
Prática guiada
Ao abrir uma página de documentação, siga esta ordem:
- Leia o título principal.
- Procure `Requirements`.
- Procure `Installation`.
- Encontre comandos em listas ou blocos de código.
- Leia `Warning` e `Note` antes de executar algo.
Resumo
Documentação básica pode ser lida por partes. Foque em títulos, listas, passos, avisos, notas e comandos.
Vocabulário
Palavras principais
The requirements are Node and Git.
Os requisitos são Node e Git.The installation is simple.
A instalação é simples.The usage section has examples.
A seção de uso tem exemplos.Warning: check the version.
Aviso: verifique a versão.Note: this step is optional.
Nota: este passo é opcional.Follow the next step.
Siga o próximo passo.The list has three commands.
A lista tem três comandos.The title is clear.
O título está claro.Skim the page for commands.
Passe os olhos pela página procurando comandos.História
História: Leitura de documentação básica
Nível: A1
História em inglês
Bianca opens the project documentation. The first title is Overview. She reads the requirements. The project needs Node and Git. Then she finds Installation. There is a short list of steps. She sees a warning before the command. The note says the command is slow.
Tradução linha a linha
| Inglês | Tradução |
|---|---|
| Bianca opens the project documentation. | Bianca abre a documentação do projeto. |
| The first title is Overview. | O primeiro título é Visão geral. |
| She reads the requirements. | Ela lê os requisitos. |
| The project needs Node and Git. | O projeto precisa de Node e Git. |
| Then she finds Installation. | Depois ela encontra Instalação. |
| There is a short list of steps. | Há uma lista curta de passos. |
| She sees a warning before the command. | Ela vê um aviso antes do comando. |
| The note says the command is slow. | A nota diz que o comando é lento. |
Vocabulário da história
| Inglês | Tradução | Observação |
|---|---|---|
| documentation | documentação | Texto que explica um projeto ou ferramenta. |
| needs | precisa | Verbo simples para necessidade. |
| slow | lento | Descreve velocidade baixa. |
Perguntas de compreensão
- What does Bianca open?
- What is the first title?
- What does the project need?
- What does Bianca see before the command?
- What does the note say?
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.