Voz passiva inicial em tecnologia

Nível: B1

Objetivo

Formar e usar a voz passiva simples (be + past participle) em documentação técnica para destacar o processo e o resultado — frases como `The bug was fixed`, `The service was deployed`, `The data is stored` — e saber quando omitir o ator ou mantê-lo com `by + agent`.

Explicação

A voz passiva troca o foco da frase: em vez de dizer *quem fez*, ela destaca *o que foi feito*. Em documentação de tecnologia isso é útil porque o ator geralmente é o próprio sistema, é desconhecido ou simplesmente não importa para o leitor.

A estrutura básica é:

> sujeito + be + past participle (+ by agent)

O verbo `be` carrega o tempo; o verbo principal aparece na forma de particípio passado (V3), que pode ser regular (`-ed`) ou irregular.

Present simple passive — `is` / `are` + V3 — descreve como algo funciona hoje, em páginas de Overview, Configuration e Architecture:

• `The data is stored in an encrypted S3 bucket.`
• `Requests are processed by the API gateway.`
• `The configuration is loaded from `config.yaml` at startup.`

Past simple passive — `was` / `were` + V3 — descreve o que aconteceu em changelogs, post-mortems e release notes:

• `The bug was fixed in version 2.4.0.`
• `The service was deployed at 02:00 UTC.`
• `The cache was cleared to avoid stale data.`

Comparação ativa × passiva:

Quando usar a passiva em tecnologia:

• O ator é o próprio sistema: `The build is triggered automatically`.
• O ator é desconhecido ou genérico: `The data is encrypted at rest`.
• O foco é o resultado e não quem fez: `The patch was released yesterday`.
• O ator já foi apresentado antes: `The ticket was assigned to the platform team`.

Quando evitá-la:

• O ator é novo e relevante: prefira ativa e nomeie a pessoa ou sistema.
• O leitor precisa agir: use imperativo (`Run the rollback script`, não `The rollback script should be run`).
• O ator é um time ou pessoa que o leitor deve procurar: escreva ativa.

`by + agent` é opcional. Use-o quando o ator agrega informação útil ao leitor — quem fez, qual time é dono, qual ferramenta foi usada. Em frases técnicas curtas, o mais comum é omitir o ator e deixar a passiva sem complemento.

Particípios irregulares comuns em tecnologia — vale memorizar porque aparecem o tempo todo em changelogs:

Verbos regulares apenas recebem `-ed` mesmo quando a grafia muda: `deploy → deployed`, `fix → fixed`, `document → documented`, `validate → validated`, `process → processed`.

A passiva em tecnologia quase sempre convive com a ativa no mesmo documento: ativa para passos, passiva para descrever processos, estados e resultados.

Exemplos

Erros comuns

• Esquecer o particípio passado e usar a forma base: `The bug was fix` deve ser `The bug was fixed`.
• Confundir V2 (passado) com V3 (particípio): `The service was deployed` está correto; `The service was deploy` não é inglês padrão.
• Trocar o auxiliar pelo tempo errado: `The data is stored` (presente) descreve o estado atual; `The data was stored` (passado) descreve algo que aconteceu — não são intercambiáveis.
• Acrescentar `by someone` ou `by people` sem necessidade: `The bug was fixed by someone` não adiciona informação; em geral, omita o ator.
• Usar passiva em passos de runbook: `The rollback script should be run` é mais longo e menos claro do que `Run the rollback script`.
• Errar a concordância com sujeito plural: `The logs is written` deve ser `The logs are written`; alinhe `is/are` e `was/were` com o sujeito.
• Esquecer verbos irregulares: `wrote` é V2 (usado na ativa: `Sam wrote the report`); na passiva use V3 — `The report was written`.

Prática guiada

Reescreva cada frase em voz passiva, decidindo se mantém ou omite o ator:

• `Sam deployed the fix at 03:14.`

→ `The fix was deployed at 03:14.` (ator omitido, o leitor não precisa saber quem fez).

• `The QA team wrote the runbook last week.`

→ `The runbook was written by the QA team last week.` (ator mantido porque identifica a área responsável).

• `The platform team restarts the service every night.`

→ `The service is restarted every night.` (ator omitido; o importante é a rotina).

Repare que, na primeira e na terceira frases, o ator não agrega informação útil e foi descartado. Na segunda, a informação `by the QA team` é parte do que o leitor precisa saber.

Resumo

A passiva simples tem a forma `be + past participle`; no presente use `is/are + V3` e no passado `was/were + V3`. Use-a em documentação para destacar processos, estados e resultados; mantenha o ator com `by + agent` só quando essa informação for útil ao leitor.

História: Voz passiva inicial em tecnologia

Nível: B1

História em inglês

The runbook is updated

On Tuesday morning, the on-call runbook for the Checkout service was reviewed by a new platform engineer. The Objective section was rewritten in a single line, and the Prerequisites section was added at the top of the document. The Steps section was kept in the imperative voice, but the Overview section was rewritten in the passive voice. All configuration values are stored in a secret manager and never in `.env` files inside the repository. The screenshots were taken by the QA team and were added to the Troubleshooting section.

The hotfix is released

On Wednesday afternoon, a critical bug was reported in the Checkout service. The issue was investigated by the on-call engineer, and the root cause was found in the payment gateway integration. A patch was written by a senior engineer and was reviewed by two other engineers before the merge. The new version was deployed at 18:42 UTC and the cache was cleared to avoid stale data. The customers were notified automatically by an in-app banner that the issue had been resolved.

The post-mortem is written

On Friday, a post-mortem document was written by the on-call engineer and shared with the whole team. The timeline section was structured around what was deployed, what was monitored, and what was rolled back. Three follow-up tasks were created and were assigned to the platform team for the next sprint. The changelog entry was finalized by the tech writer and was published on the status page the same afternoon. Since the new runbook was followed end to end, the next on-call shift started with confidence instead of uncertainty.

Tradução linha por linha

Notas de vocabulário

• was reviewed by = passado simples passivo com by + agent; destaca o resultado da revisão
• was rewritten = rewritten é V3 de rewrite; passiva no past simple
• was added at the top = passiva de posição no documento; ator omitido porque é o próprio time
• are stored in a secret manager = present simple passive; descreve o estado atual do sistema
• were taken by the QA team = passiva com by + agent; nomeia a área responsável pelos screenshots
• was investigated by = passiva em post-mortem; destaca o fato de a investigação ter acontecido
• was found in = find é irregular (V3: found); passiva para indicar onde algo foi localizado
• was deployed at 18:42 UTC = passiva com horário exato; muito comum em changelogs e timelines
• was cleared to avoid = passiva seguida de finalidade (to + verbo); mostra o motivo da ação
• were notified automatically = passiva com advérbio; foco no público notificado, não no autor da mensagem
• was shared with = passiva com destinatário explícito; comum em relatórios e post-mortems
• were assigned to = passiva com responsável; muito usada em listas de tarefas e follow-ups

Perguntas de compreensão

1. Who reviewed the on-call runbook on Tuesday morning?
2. Where are the configuration values stored according to the new Overview?
3. Who took the screenshots that were added to the Troubleshooting section?
4. Where was the root cause of the Wednesday bug found?
5. At what time was the new version deployed?
6. Why was the cache cleared?
7. Who wrote the post-mortem document on Friday?
8. How many follow-up tasks were created after the incident?
9. What was published on the status page on Friday afternoon?
10. How did the next on-call shift feel, according to the last line of the story?

Prática com a história

1. Passe para a voz passiva: A new platform engineer reviewed the runbook on Tuesday morning.
2. Passe para a voz passiva: The on-call engineer investigated the issue on Wednesday afternoon.
3. Passe para a voz passiva: The tech writer finalized the changelog on Friday afternoon.
4. Complete a passiva: The post-mortem ___ (write) by the on-call engineer.
5. Passe para a voz passiva: The platform team assigned three follow-up tasks to the next sprint.