Vocabulário de bugs e debugging

Nível: A2

Objetivo

Aprender o vocabulário essencial para descrever e reportar bugs em inglês: bug, issue, crash, freeze, log, stack trace, reproduce, expected, actual, steps; e usar essas palavras para escrever um bug report A2 simples.

Explicação

Em trabalho de software, bug e issue aparecem o tempo todo. Bug é qualquer defeito no software. Issue é o registro (ticket) que documenta esse defeito, geralmente aberto no repositório (GitHub, GitLab, Jira). Em mensagens curtas, os dois podem se referir ao mesmo problema, mas bug é a coisa e issue é o papel que a coisa vira no sistema.

Para descrever o que aconteceu, use crash e freeze com cuidado:

• crash: a aplicação fechou sozinha, muitas vezes com erro.
• freeze: a aplicação parou de responder, mas a janela continua aberta.

Para investigar, você lê logs (registros de eventos do sistema ou do app) e o stack trace (a lista de chamadas de função no momento do erro). O verbo reproduce significa fazer o bug acontecer de novo, geralmente seguindo os steps (passos) numerados.

Em um bug report A2, a estrutura mais simples é:

• Title: frase curta que resume o problema.
• Steps to reproduce: 1) ..., 2) ..., 3) ...
• Expected: o que deveria acontecer.
• Actual: o que realmente acontece.
• Environment: navegador, sistema operacional, versão do app.
• Severity: high / medium / low (ou critical).

Os adjetivos expected e actual aparecem sempre juntos e nesta ordem: `Expected: the page loads.` `Actual: the page is blank.` Para indicar gravidade, use severity (high/medium/low) ou priority (P1/P2/P3) dependendo do time.

Exemplos

Erros comuns

• Confundir crash (o app fecha) com freeze (o app trava sem fechar).
• Misturar log (substantivo, registro) com log in (verbo, entrar): `I read the log in` está errado; diga `I read the log` ou `I logged in`.
• Esquecer a preposição to em steps to reproduce: `steps reproduce` é um erro comum.
• Trocar expected e actual no bug report: expected vem antes, actual descreve o erro.
• Dizer `the bug is reproducing` em vez de `I can reproduce the bug` (reproduce aqui é transitivo, precisa de objeto).
• Abrir a issue com título vago como `bug` ou `it doesn't work`; o título deve resumir o problema.

Prática guiada

Preencha um bug report mínimo:

• Title: ____________________________________
• Steps to reproduce: 1) ___, 2) ___, 3) ___
• Expected: ____________________________________
• Actual: ____________________________________
• Environment: ____________________________________
• Severity: ____________________________________

Resposta-modelo:

• Title: `Export button does nothing on Chrome`
• Steps to reproduce: 1) Log in, 2) Open the report, 3) Click Export.
• Expected: `A PDF downloads.`
• Actual: `Nothing happens. The page freezes.`
• Environment: `Chrome 120, Windows 11, build 4321`
• Severity: `Medium`

Resumo

Bug é o defeito; issue é o ticket. Crash significa que o app fechou, freeze que travou sem fechar. Para investigar, leia o log e o stack trace. Em um bug report, liste steps to reproduce, expected, actual, environment e severity.

História: Vocabulário de bugs e debugging

Nível: A2

História em inglês

A strange freeze on Monday

Last Monday, the QA team opened a new ticket in the repository. The dashboard froze right after the latest update. Sam wrote in the team channel: "The dashboard froze on Chrome 120, Windows 11." His teammate asked, "Did you restart the service?" Sam answered, "Yes, I did, but the page didn't load. It just froze."

Reading the log

Sam opened the server log and searched for the latest error. The stack trace pointed to the import step in the worker. He asked the team, "Did anyone deploy a new version of the worker on Friday?" One engineer answered, "Yes, I did. I deployed a small refactor." They reproduced the bug on the staging environment. "Found it!" Sam wrote. "The worker doesn't handle empty files."

Filing the bug report

Sam opened a new issue in the repository with the title: "Dashboard freezes after worker deploy". He listed the steps to reproduce: 1) Deploy the new worker, 2) Open the dashboard, 3) Wait five seconds. Expected: the dashboard shows the latest data. Actual: the page freezes and the spinner never stops. Environment: Chrome 120, Windows 11, build 4321. Severity: medium. The team reviewed the report and started the fix on the same day.

Tradução linha por linha

Notas de vocabulário

• froze = Passado de freeze; descreve app que travou sem fechar.
• stack trace = Lista de chamadas de função no momento do erro; ajuda a localizar a linha com problema.
• steps to reproduce = Passos numerados para fazer o bug acontecer de novo; expressões fixa com 'to'.
• Expected = Campo do bug report que descreve o comportamento correto.
• Actual = Campo do bug report que descreve o que realmente acontece, geralmente o bug.
• Severity = Gravidade do bug; comum usar high / medium / low.

Perguntas de compreensão

1. What happened to the dashboard on Monday?
2. Did Sam restart the service?
3. What did the stack trace point to?
4. Did anyone deploy a new version of the worker on Friday?
5. What is the title of the bug report Sam opened?
6. What is the severity of the bug?

Prática com a história

1. Traduza: O log do servidor mostrou um erro às 2h14.
2. Complete: 'Steps ___ reproduce: 1) log in, 2) open Settings.'
3. Escreva Expected e Actual para um bug em que o app fecha ao clicar em 'Exportar'.
4. Pergunte a um colega se ele conseguiu reproduzir o bug.