C1 · Avanzado · 6 lecciones
Escritura técnica en inglés
Concisión, precisión, registro y estructura en documentos que se leen de verdad. Estas son las frases, la gramática y los ejemplos que usarás de verdad, explicados en español.
Decirlo en menos palabras
Elimina relleno y frases vacías.
Frases clave
| Inglés | Español |
|---|---|
| The service retries failed requests. | El servicio reintenta las peticiones fallidas. |
| We need to decide by Friday. | Tenemos que decidir antes del viernes. |
| This change affects only internal users. | Este cambio solo afecta a usuarios internos. |
Gramática · Concisión
in order to → to · due to the fact that → because · at this point in time → now · make a decision → decide
Muchas expresiones largas tienen una versión corta igual de precisa. Usar el verbo directo (decide) en vez de verbo + sustantivo (make a decision) también acorta.
Because the cache was cold, the first request was slow.
Como la caché estaba fría, la primera petición fue lenta.
💡 Si una frase empieza por “It is important to note that…”, casi siempre puedes borrar esas seis palabras.
Así lo dirías
Mark: Summarise this week's progress in one or two concise sentences.
Tú: We finished eight of ten tasks. The last two are blocked on the vendor and should land on Monday.
“At this point in time” y “make the completion of” son relleno. Verbos directos y números dicen más en menos palabras.
Activa o pasiva
Elige la voz que aclara, no la que suena formal.
Frases clave
| Inglés | Español |
|---|---|
| The scheduler assigns each job to a worker. | El planificador asigna cada trabajo a un worker. |
| Personal data is encrypted at rest. | Los datos personales se cifran en reposo. |
| Leo's team owns the deployment pipeline. | El equipo de Leo es responsable del pipeline de despliegue. |
Gramática · Activa frente a pasiva
Activa: quién + verbo + qué · Pasiva: qué + be + participio (+ by)
La activa es más clara cuando importa quién lo hace (responsabilidades, componentes). La pasiva es mejor cuando el actor da igual o es obvio (datos, resultados).
The API gateway validates every token, and invalid requests are rejected.
El gateway valida cada token, y las peticiones inválidas se rechazan.
💡 En un runbook, la pasiva sin actor (“the service must be restarted”) deja sin claro quién lo hace: escribe “the on-call engineer restarts the service”.
Así lo dirías
Priya: Explain who does what when a new customer signs up, as you'd write it in the design doc.
Tú: When a customer signs up, the auth service creates the account, the mailer sends a welcome email, and the fraud service checks the payment details.
Tantas pasivas esconden qué componente hace cada cosa. En un design doc, la activa deja clara la responsabilidad.
Palabras precisas
Sustituye palabras vagas por términos exactos.
Frases clave
| Inglés | Español |
|---|---|
| The outage affected roughly 4% of requests. | La caída afectó aproximadamente al 4 % de las peticiones. |
| We mitigated the issue by rerouting traffic. | Mitigamos el problema redirigiendo el tráfico. |
| Latency increased steadily over the afternoon. | La latencia aumentó de forma constante durante la tarde. |
Gramática · Verbos y adverbios precisos
fix → mitigate / resolve · big → significant · a lot → roughly 40% · went up → increased steadily / spiked
En escritura técnica, cada palabra tiene un matiz. Mitigate (reducir el impacto) no es resolve (eliminar la causa). Steadily (gradual) no es sharply (de golpe).
We mitigated the outage within ten minutes and resolved the root cause the next day.
Mitigamos la caída en diez minutos y resolvimos la causa al día siguiente.
💡 Si puedes poner un número, ponlo: “roughly 40%” es mejor que “a lot”.
Así lo dirías
Mark: Describe what happened to the error rate during yesterday's incident, precisely.
Tú: The error rate spiked from 0.2% to 9% at 14:05. We mitigated it within ten minutes by rerouting traffic, and resolved the root cause that evening.
Spiked, mitigated y resolved dicen exactamente qué pasó; las horas y cifras sustituyen a “a lot” y “more or less”.
Conectar ideas con precisión
Une ideas con relaciones lógicas exactas.
Frases clave
| Inglés | Español |
|---|---|
| We introduced a queue, thereby decoupling the two services. | Introdujimos una cola, desacoplando así los dos servicios. |
| This is a process whereby each team reviews its own alerts. | Es un proceso mediante el cual cada equipo revisa sus propias alertas. |
| The data is cached at the edge, hence the lower latency. | Los datos se cachean en el edge, de ahí la menor latencia. |
Gramática · Conectores formales avanzados
thereby + -ing (con lo cual) · whereby (mediante el cual) · hence + sustantivo (de ahí)
Thereby introduce la consecuencia de lo anterior con -ing. Whereby describe un mecanismo. Hence resume la causa de algo que ya se ve.
Jobs are retried automatically, thereby reducing manual work.
Los trabajos se reintentan automáticamente, reduciendo así el trabajo manual.
💡 Úsalos en documentos formales; en Slack sonarían pomposos.
Así lo dirías
Sarah: Explain in one formal sentence how your new on-call process works and what it achieves.
Tú: We've introduced a process whereby each team owns and tunes its own alerts, thereby reducing the number of pages for everyone by around half.
Whereby describe el mecanismo y thereby + -ing la consecuencia: registro formal perfecto para un documento. Fewer pages, no less.
Estructurar para quien lee en diagonal
Escribe para lectores con prisa.
Frases clave
| Inglés | Español |
|---|---|
| TL;DR: we recommend option B and need a decision by Friday. | Resumen: recomendamos la opción B y necesitamos una decisión para el viernes. |
| This section explains why the current design doesn't scale. | Esta sección explica por qué el diseño actual no escala. |
| Each paragraph opens with its main point. | Cada párrafo empieza con su idea principal. |
Gramática · Escritura para escanear
TL;DR arriba · topic sentence al inicio de cada párrafo · listas para opciones · la petición, clara
La mayoría de lectores solo leen el resumen y la primera frase de cada sección. Pon ahí lo esencial.
TL;DR: migrating saves 30% and takes six weeks; we need approval by the 10th.
Resumen: migrar ahorra un 30 % y lleva seis semanas; necesitamos la aprobación para el día 10.
💡 Una buena topic sentence se entiende sola: “Option A is cheaper but harder to scale.”
Así lo dirías
Mark: Give me the TL;DR of your proposal in fifteen seconds.
Tú: TL;DR: moving our logs saves 35% and simplifies on-call. It takes about three weeks, and I need a go/no-go from you by the 15th.
Un TL;DR empieza por la conclusión, no por el contexto. Beneficio, coste y lo que pides, en dos frases.
Repaso: escribir como un staff engineer
Conciso, preciso, bien conectado y escaneable.
Frases clave
| Inglés | Español |
|---|---|
| I've cut this down to one page. | Lo he reducido a una página. |
| Happy to add more detail in an appendix. | Encantado de añadir más detalle en un anexo. |
| Could you read it with fresh eyes before I share it? | ¿Podrías leerlo con ojos nuevos antes de que lo comparta? |
Gramática · Repaso de la unidad
concisión · activa cuando importa quién · mitigate/resolve · thereby/whereby/hence · TL;DR arriba
Escribir bien es elegir: menos palabras, la voz adecuada, el término exacto, el conector justo y lo importante al principio.
TL;DR: we mitigated the issue by rerouting traffic, thereby avoiding customer impact.
Resumen: mitigamos el problema redirigiendo el tráfico, evitando así el impacto en clientes.
💡 Pide a alguien que lea solo el TL;DR y te diga qué entiende: si no coincide con tu intención, reescríbelo.
Así lo dirías
Priya: A colleague's design doc is 12 pages long and nobody reads it. What advice would you give?
Tú: I'd add a TL;DR at the top with the recommendation and the decision you need, open each section with its main point, and move the detail to an appendix. One page is usually enough for the people who decide.
Consejos concretos (TL;DR, topic sentences, anexo) en lugar de “more short”, que además es incorrecto (shorter).