Cómo leer código en inglés con precisión

Resumen

Leer código en inglés tiene dos caminos muy distintos: uno cuando explicas la lógica a un compañero y otro cuando dictas la sintaxis exacta. Si trabajas en programación y quieres comunicarte mejor con equipos internacionales, dominar el nombre de cada símbolo y las convenciones de nombrado es la base que necesitas.

¿Cómo se lee código en inglés según el contexto?

Existen dos formas válidas de leer un fragmento de código y cada una sirve a un propósito distinto.

Cuando hablas de la lógica, ignoras símbolos y reordenas términos para que la frase suene natural. Una condición como if (x < width) { console.log('inside') } else { alert('error') } la leerías así: si la coordenada X es menor que el ancho del cuadro, registra el valor inside; de lo contrario, muestra un mensaje de error.

Cuando dictas la sintaxis a alguien que está escribiendo, cada símbolo cuenta. Con práctica puedes omitir corchetes obvios y decir algo como console.log string inside, alert string error, pero las palabras técnicas deben ser precisas.

¿Cuál es la diferencia entre leer lógica y leer sintaxis? La lógica describe qué hace el código en lenguaje natural. La sintaxis nombra cada símbolo y palabra reservada para que otra persona pueda escribirlo igual.

¿Cuáles son los nombres correctos de los símbolos en código?

Conocer el nombre exacto de cada carácter evita malentendidos cuando trabajas en equipos en inglés.

Espacios, paréntesis y llaves

El espacio al inicio de una línea se llama indentation o sangría. Algunos lenguajes como Python son sensibles a ella, otros no, pero el código bien indentado siempre se lee mejor. Hay debate eterno entre usar tabs o spaces, y cuántos.

Los agrupadores tienen nombres específicos en inglés:

  • Parentheses o parens: los redondos ( ), siempre con opening y closing.
  • Curly braces o braces: los rizados { }.
  • Brackets o square brackets: los cuadrados [ ].

Usar la palabra calificativa, como curly braces o square brackets, evita confusiones cuando hablas rápido.

Comillas, puntos y operadores

Las comillas también tienen variantes. Tienes single quote, double quote y backtick, esa que está junto a la tecla Escape y que algunos lenguajes usan para template strings. Las curly quotes son las tipográficas que usan los diseñadores en texto, no en código.

El punto cambia de nombre según el contexto, y aquí viene lo interesante:

  • En decimales como 1.75 se dice point.
  • En versiones como 1.75.0 se dice point, pero el cero suele leerse como la letra O.
  • En notación de objetos como console.log se dice dot.
  • En dominios como platzi.com se dice dot, nunca point.
  • Al final de una oración se llama period o full stop.

Los operadores básicos son plus, minus, asterisk (también times para multiplicación) y slash para división. Y ojo con los guiones: existen el hyphen, el en dash y el em dash, llamados así porque tienen el ancho de la letra N o M.

Símbolos de la fila superior del teclado

Los caracteres encima de los números tienen nombres que conviene memorizar:

  • Tilde (~), lo que va sobre la ñ.
  • Exclamation mark o bang (!).
  • At sign (@), usado en correos.
  • Hash o pound (#), nunca hashtag por sí solo. El hashtag aparece solo cuando precede a una palabra. Su nombre formal es octothorpe.
  • Caret (^), ese sombrerito que aparece en operaciones lógicas.
  • Ampersand (&), cuyo nombre viene de and per se and, una mezcla de inglés y latín cuando esta letra cerraba el alfabeto.

¿Qué son foo, bar y las naming conventions en programación?

Más allá de la puntuación, hay convenciones que rigen cómo se nombran variables y funciones en código.

Las palabras foo, bar y a veces baz se usan desde los años 60 como variables genéricas o de ejemplo. No tienen significado, son placeholders para cuando necesitas un nombre temporal. Si las ves en documentación, no busques sentido oculto.

¿Qué significa foobar en programación? Es un término inventado para nombrar variables sin un propósito específico, usado en ejemplos y código temporal desde hace décadas.

Cuando una variable tiene dos palabras y necesitas eliminar el espacio, hay cuatro convenciones populares:

  • flat case: todo junto y en minúsculas, como myvariable.
  • camelCase: la segunda palabra inicia en mayúscula, como myVariable. JavaScript la usa casi siempre. Se llama así por la joroba que forma la mayúscula.
  • snake_case: palabras unidas por guion bajo, como my_variable. Ruby y muchos sistemas Unix la prefieren. El nombre viene de que el guion bajo parece una serpiente en el suelo.
  • kebab-case: palabras unidas con hyphen, como my-variable. No funciona en variables porque los lenguajes interpretan el guion como signo menos, pero brilla en nombres de archivos y módulos de Node.js. Se llama así porque los guiones recuerdan al palito del shish kebab.

¿Cuándo usar camelCase, snake_case o kebab-case? Usa camelCase en JavaScript, snake_case en Ruby y archivos Unix, y kebab-case para nombres de módulos y archivos donde el lenguaje lo permita.

¿Cómo practicar la lectura de código en inglés?

Un ejercicio poderoso es tomar un fragmento de código que ya hayas escrito y grabarte leyéndolo dos veces: primero como lógica del código y después como sintaxis exacta, símbolo por símbolo.

Esa doble lectura entrena tu oído para reuniones técnicas, pair programming y entrevistas en inglés. Comparte tu grabación en los comentarios y cuéntame qué símbolo te costó más nombrar.