Cómo hablar sobre código en inglés

to declare

Introducir una variable, constante, función o clase por primera vez.

“I declared a constant at the top so it's easy to update later.”

to initialize

Asignar un valor inicial a una variable, o configurar un objeto para que esté listo para usarse.

“The constructor initializes the database connection and sets the default timeout.”

to call / invoke

Ejecutar una función o método.

“This middleware is called on every request before it reaches the route handler.”

to pass

Proporcionar un valor como argumento a una función.

“The route handler passes the user ID and the token as separate arguments so the function stays testable.”

to return

Enviar un valor de vuelta desde una función al código que la llamó.

“If validation fails, the function returns early with an error object.”

to iterate / loop through

Recorrer una colección de elementos uno por uno.

“The script iterates over the list of events and filters out anything older than 30 days.”

to check / validate

Verificar que una condición es verdadera o que un valor cumple ciertos requisitos.

“Before inserting the record, the service checks whether a row with that email already exists.”

to handle

Gestionar explícitamente en el código un evento, error o caso extremo.

“This catch block handles the case where the external API is unreachable.”

to throw

Lanzar una excepción, interrumpiendo la ejecución normal y pasando el control a un manejador de errores.

“The validator throws a custom exception so the caller knows exactly what went wrong.”

to parse

Leer e interpretar datos estructurados (JSON, XML, una cadena de texto) y convertirlos en un formato utilizable.

“The middleware parses the response body and maps it to our internal User type.”

to instantiate

Crear una nueva instancia de una clase.

“The app instantiates a new HTTP client on startup and reuses it across requests.”

to extend / inherit from

Crear una clase que se construye sobre otra, heredando su comportamiento.

“This class extends the base repository and adds pagination support.”

to implement

Proporcionar el código real para una interfaz, clase abstracta o firma de función.

“The PaymentService class implements the IPaymentProvider interface.”

to override

Reemplazar un método de una clase padre con una nueva versión en una clase hija.

“I overrode the default serialize method to exclude the password field from the output.”

to expose

Hacer que una función, variable o endpoint esté disponible para otras partes del código o para el exterior.

“This module exposes a single function — everything else is kept private.”

This [function / method / class] [verb] ...

Cuándo usarlo

La forma más natural de comenzar cualquier explicación de código. Elige un verbo de la lista anterior.

It takes [X] and returns [Y].

Cuándo usarlo

Para describir las entradas y salidas de una función. Útil al inicio de un walkthrough.

First, ... Then, ... Finally, ...

Cuándo usarlo

Para recorrer una secuencia de pasos en orden.

If [condition], then [consequence].

Cuándo usarlo

Para explicar lógica condicional o casos extremos.

The reason we [did X] is [because / so that] ...

Cuándo usarlo

Para explicar una decisión de diseño o una elección no obvia en el código.

This is where [X] happens.

Cuándo usarlo

Para señalar una línea o bloque específico durante un walkthrough en vivo o una code review.

We use [X] here instead of [Y] because ...

Cuándo usarlo

Para explicar una compensación técnica o por qué no se eligió una alternativa.

This could break if ...

Cuándo usarlo

Para señalar un riesgo, caso extremo o suposición en el código.

“Let me walk you through this.”

Cuándo usarlo

Para abrir una explicación de código, una pantalla compartida o una demo.

“Let me walk you through how the authentication flow works from the moment the user submits the form.”

“Starting from the top ...”

Cuándo usarlo

Para comenzar un walkthrough de arriba hacia abajo de un archivo o función.

“Starting from the top: we import the dependencies, then we define the schema, then we export the handler.”

“If you look at line [N] ...”

Cuándo usarlo

Para dirigir la atención a una parte específica del código.

“If you look at line 42, that's where we set the default timeout — it's currently 5 seconds.”

“The happy path is ...”

Cuándo usarlo

Para explicar qué sucede cuando todo funciona como se espera, antes de cubrir los casos de error.

“The happy path is: request comes in, token is valid, data is fetched, response is returned. The error handling is further down.”

“The tricky part here is ...”

Cuándo usarlo

Para señalar una sección de código que es compleja, contraintuitiva o fácil de equivocar.

“The tricky part here is the order of operations. The cleanup function runs before the callback, which is not obvious.”

“I left a comment explaining ...”

Cuándo usarlo

Para referirse a comentarios en línea del código durante una revisión o walkthrough.

“I left a comment explaining why we do the null check before the loop — the API can return undefined in some cases.”

“Does this make sense so far?”

Cuándo usarlo

Para hacer una pausa durante una explicación y verificar la comprensión.

“So the middleware runs before every request and attaches the user object to the context. Does this make sense so far?”

“Any questions about this part?”

Cuándo usarlo

Para invitar preguntas después de explicar una sección específica.

“That covers the data layer. Any questions about this part before I move on to the API routes?”

“I'll skip over [X] for now — the important thing is ...”

Cuándo usarlo

Para mantener un walkthrough enfocado, aplazando detalles menos relevantes.

“I'll skip over the error handling for now — the important thing is to understand the main data flow.”

“This is a bit of a workaround because ...”

Cuándo usarlo

Para reconocer que el código no es ideal y explicar la restricción que llevó a ello.

“This is a bit of a workaround because the third-party library doesn't support async callbacks in this version.”