Atlasingeniería

Inglés técnicoLectura técnica — JuniorTema 1Junior

Las palabras que aparecen todos los días

No hace falta saber inglés para leer documentación técnica: hace falta conocer unas doscientas palabras que se repiten siempre. El problema no son las difíciles, son las que parecen que significan una cosa y significan otra.

Leer documentación técnica en inglés no requiere el vocabulario de una novela. El texto técnico es repetitivo a propósito: las mismas doscientas palabras aparecen una y otra vez, y la mayoría se aprenden por contexto en unas semanas de lectura.

El obstáculo real es otro: las palabras que se parecen a una castellana y significan otra cosa. Ahí no hay confusión visible —se entiende algo, pero lo equivocado— y el error puede sobrevivir años sin que nadie lo corrija.

Los falsos amigos del software

En inglésPareceSignificaCómo se dice lo que parecía
actualactualreal, verdadero«current» es actual
eventuallyeventualmentecon el tiempo, finalmente«occasionally» es eventualmente
librarylibreríabiblioteca de código«bookstore» es la librería
deprecateddepreciadodesaconsejado, va a desaparecer«depreciated» es depreciado
sensiblesensiblerazonable, sensato«sensitive» es sensible
assistasistir (ir)ayudar«attend» es asistir a un lugar
argumentargumento (razón)parámetro que se pasaambas existen, según contexto
supportsoportar (tolerar)admitir, ser compatible con«withstand» es soportar peso
commoditycomodidadbien intercambiable«convenience» es comodidad
realizerealizardarse cuenta«perform» o «carry out» es realizar
La segunda fila es la más cara: «eventually consistent» no significa que la consistencia sea eventual, significa que llega con el tiempo, siempre.

Antes de seguir, predecí

Un servicio se describe como «eventually consistent». ¿Qué garantiza?

El núcleo que se repite

Estas aparecen en casi cualquier documentación, y conviene tenerlas sin pensar:

GrupoPalabrasCómo se usan
Cambiosadd, remove, update, rename, replace, revert, bump«bump the version» es subir la versión
Estadoenable, disable, toggle, override, default, fallback«falls back to» es recurre a, si lo otro falla
Fallasfail, crash, hang, leak, throw, retry, timeout«it hangs» es se queda colgado
Flujotrigger, handle, dispatch, listen, subscribe, poll«poll» es consultar cada tanto
Datosfetch, parse, serialize, cache, flush, purge«flush» es vaciar lo que estaba en el medio
Advertenciasdeprecated, breaking change, caveat, known issue, workaround«caveat» es una advertencia con letra chica
Un rato con estas seis filas cubre buena parte de lo que aparece en un changelog cualquiera.

Cómo suenan las que más se dicen

  • cache

    /kæʃ/ · suena como cash

    Error común: decir «cachÉ», con acento en la e, que es otra palabra (cachet)

  • query

    /ˈkwɪəri/ · suena como kuíri

    Error común: decir «query» como se lee en castellano, «kéri»

  • queue

    /kjuː/ · suena como kiú

    Error común: intentar pronunciar todas las vocales; suena igual que la letra Q

  • deprecated

    /ˈdeprəkeɪtɪd/ · suena como déprekeited

    Error común: decir «depriquéited», con acento en la segunda sílaba

  • suite

    /swiːt/ · suena como suít

    Error común: decir «suíte» en dos sílabas; suena igual que sweet

Cinco que se escuchan mal todos los días. Si tu navegador tiene una voz en inglés instalada, aparece el botón para escucharlas.

Cómo se amplía sin estudiar listas

Lo que funciona

  1. Leé en inglés lo que ya ibas a leer. La documentación de lo que usás, no textos elegidos para practicar. El contexto hace la mitad del trabajo.
  2. No traduzcas palabra por palabra. Leé el párrafo entero y quedate con la idea; la palabra que falta suele aclararse sola dos líneas después.
  3. Anotá sólo las que te frenaron dos veces. Si te frenó una vez, no vale el esfuerzo; si te frenó dos, va a volver.
  4. Fijate cómo la usan, no qué significa. «Fall back to» se aprende viendo tres ejemplos mucho mejor que con una traducción.
  5. Aceptá entender el 80 %. Es suficiente para trabajar, y es como lee casi todo el mundo, incluidos los que hablan inglés.

Lo que preguntan sobre esto

Cierre

Autoevaluación

¿Lo entendiste?

«The service is eventually consistent» significa…
«This behaviour is deprecated» quiere decir que…
«A sensible default» es…
¿Cómo se pronuncia «queue»?
¿Qué conviene anotar mientras leés en inglés?