Explicar código y decisiones en voz alta
Contar cómo funciona algo que escribiste vos es la conversación en inglés más frecuente de un equipo remoto: en un pair, en una revisión, en una entrevista. Tiene un orden que la vuelve fácil, y es el inverso del que sale natural.
Cuando alguien pregunta “can you walk me through this?”, el instinto es empezar por donde empezaste vos: el archivo que abriste primero, el bug que te llevó ahí, la función que tuviste que cambiar. Y quien escucha se pierde en treinta segundos.
Explicar bien en voz alta —en inglés o en el idioma que sea— es contar la historia al revés de como la viviste: primero qué hace, después cómo, y sólo al final los detalles. El inglés que hace falta para eso es de nivel básico; el orden es lo difícil.
De arriba hacia abajo
| Nivel | Qué se dice | Ejemplo |
|---|---|---|
| 1. Qué hace | Una oración, en presente, sin detalles | This service turns invoice PDFs into structured JSON |
| 2. Por dónde entra y sale | La forma general del flujo | It picks up files from a queue, parses them, and writes rows to Postgres |
| 3. Las partes | Tres o cuatro, con su responsabilidad | There's a reader, a parser and a writer. The parser is where the interesting part is |
| 4. La decisión que importa | Lo no obvio, con su porqué | We parse page by page instead of loading the whole file, because some invoices are 200 pages |
| 5. El detalle | Sólo si preguntan | The regex handles the two date formats our suppliers use |
| Momento | Fórmula |
|---|---|
| Abrir la explicación | At a high level, this… · The short version is… |
| Anunciar las partes | There are three moving pieces here: … |
| Bajar un nivel | Let me zoom in on the parser — that's where the tricky part is |
| Señalar lo no obvio | The non-obvious bit is that… · One thing worth knowing: … |
| Justificar una decisión | We went with X because … The trade-off is … |
| Reconocer algo feo | This part is not pretty — it works around a bug in the provider's SDK |
| Chequear que se entienda | Does that make sense so far? · Want me to go deeper anywhere? |
| Admitir que no sabés | I'm not sure — that predates me. I can find out |
Antes de seguir, predecí
Hablar mientras pensás
En una conversación en vivo hay un problema que la escritura no tiene: pensar y hablar al mismo tiempo, en un idioma que no es el tuyo. Las fórmulas de relleno no son un vicio, son la herramienta que mantiene el turno mientras ordenás la idea.
| Situación | Qué decir | Por qué funciona |
|---|---|---|
| Necesitás dos segundos | Let me think for a second… · Good question, give me a moment | Mantiene el turno; el silencio hace que el otro empiece a hablar |
| Te falta una palabra | I don't know the word — it's the thing that… · how do I say this… | Describir el concepto siempre funciona y nadie lo juzga |
| Te equivocaste al explicar | Sorry, scratch that — it's actually the other way around | Corregirse en voz alta es normal y genera confianza |
| Perdiste el hilo | Where was I? … Right, the parser | Todo el mundo lo dice, también los nativos |
| Querés confirmar que entendiste la pregunta | Just to make sure I understood: you're asking about X, right? | Evita responder tres minutos a la pregunta equivocada |
| Te preguntan algo que no sabés | I don't know off the top of my head — let me check and get back to you | Es una respuesta profesional, no una falla |
Practicalo
Reescribilo
Alguien pidió «walk me through this service» y la respuesta arranca por el detalle. Reescribila —como si la fueras a decir en voz alta— empezando por qué hace y para quién.
so in the index file we import the config and then there is a function called processAll that has a for loop, inside the loop we call parsePage which uses a regex I copied from the old script, and there is also a retry somewhere, I think in the writerAt a high level: this service turns supplier invoice PDFs into rows in our billing database. It picks files up from a queue, parses them page by page, and writes the line items to Postgres. There are three pieces: a reader, a parser and a writer. The parser is the interesting one — invoices come in two date formats, so that's where most of the logic lives. One non-obvious decision: we parse page by page instead of loading the whole file, because some invoices are 200 pages and we were running out of memory. Does that make sense so far? I can go deeper into any of the three.
Cinco párrafos cortos que bajan un nivel cada uno, y cualquiera de ellos puede ser el último. El regex y el retry aparecen si los preguntan.
Short version: it turns invoice PDFs into billing rows. Queue in, Postgres out, with a parser in the middle that handles the two date formats our suppliers use. Want me to go deeper anywhere?
La versión de treinta segundos, para cuando el otro está de paso o la reunión va corta. Mismo orden: qué, cómo, y una invitación a bajar de nivel.
Las dos versiones usan inglés más simple que el original. Explicar bien no requiere vocabulario: requiere orden.
Can you walk me through it?
/kən juː wɔːk miː θruː ɪt/ · suena como kan iu uók mi zrú it
Error común: pronunciar la l de «walk»: es muda
Es la forma más común de pedir una explicación. «Walk through» es recorrer algo paso a paso.
At a high level
/ət ə haɪ ˈlevl̩/ · suena como at a jái lével
Error común: decir «hái» sin la j aspirada inicial
Off the top of my head
/ɒf ðə tɒp əv maɪ hed/ · suena como of de top ov mai jéd
Error común: traducirlo literal
Significa «así de memoria, sin buscarlo».
Does that make sense?
/dʌz ðæt meɪk sens/ · suena como das dat méik sens
Error común: decir «dus» en vez de «das»
The trade-off is
/ðə ˈtreɪdɒf ɪz/ · suena como de tréidof is
Error común: acentuar «tradeóf»
El audio lo genera tu navegador con voz sintetizada: alcanza para orientarse, y una persona que habla inglés lo dice mejor.
Lo que preguntan sobre esto
En la práctica
Cierre
Autoevaluación
¿Lo entendiste?
Práctica