En tu propio idioma

De un vistazo

Si abriste esta documentación, la viste en un idioma que de verdad lees —no en uno que apenas alcanzas a descifrar— y tu primer impulso fue mirar dos veces, quizá leer una frase o dos solo para comprobar si fluyen, entonces ya nos entendemos. Ese segundo vistazo es la razón de ser de esta página. Si en este momento estás leyendo esto en un idioma que no es el inglés, es justo lo que esperábamos.

El espacio entre entender y querer

Los lenguajes del diseño de software se escriben en inglés, y para la mayoría de los ingenieros un manual en inglés es lo más natural del mundo. Con unas pocas herramientas a mano, se maneja perfectamente. Pero si tu primera lengua no es el inglés, conoces esa sensación de que algo sigue interponiéndose entre tú y la página: una capa fina y constante de traducción que vas haciendo en tu cabeza mientras lees la referencia, y otra vez mientras escribes la tuya.

Lo sabemos porque también es lo nuestro. Somos ingenieros cuya primera lengua no es el inglés y que llevamos años leyendo manuales en inglés y escribiendo documentación y código en inglés. Por eso sentimos, con más nitidez que la mayoría, la distancia entre un artículo que simplemente lees y uno que tienes que esforzarte por entender. Los dos pueden dejarte informado; solo uno te deja a gusto. Poder entender algo y poder disfrutarlo no son lo mismo, y de esa diferencia trata todo este esfuerzo.

Por qué dieciocho idiomas

Cuando recorres la lista de idiomas y cuentas cerca de veinte entradas —algunas de ellas no precisamente las lenguas más dominantes del mundo—, eso no es un accidente ni una casilla que se marca por trámite. Está ahí porque queremos que esto te guste: el producto en sí, y aquello sobre lo que está construido. El PDF es un sistema basado en reglas: un formato de documento portátil definido, hasta en su modelo de objetos y su sintaxis, por una norma formal (ISO 32000-2). A nosotros nos fascina, sin alardes, y nos gustaría que a ti también te fascinara.

Por eso también algunos de estos artículos se leen menos como una referencia árida y más como una historia cercana sobre cómo funciona el PDF de verdad. Si alguno te explica algo de lo que jamás habías oído hablar, no te preocupes ni por un segundo: no eres el único. Antes de sentarnos a leer la ISO 32000-2 nosotros mismos, tampoco lo sabíamos. Una página que te enseña algo nuevo sobre el formato, en un lenguaje en el que puedes relajarte, es una página que cumple su función.

Especialmente para el sudeste asiático

Las grandes lenguas del mundo se daban por sentadas. Lo que nos empeñamos en añadir fueron las del sudeste asiático: el indonesio, el tailandés y el vietnamita. Europa, América y el noreste de Asia tienen culturas de software largas y profundas, y desde hace mucho cuentan con una documentación a la altura. El sudeste asiático tiene una de las escenas de software que más rápido crecen en el mundo y, aun así, la documentación de primera categoría en lengua nativa suele ser la última en llegarle. No queríamos ser una herramienta más que lo tratara como algo secundario.

Y seas quien seas —un estudiante, un ingeniero junior en su primer proyecto de verdad, alguien que construye por su cuenta, un equipo que está integrando el PDF en su stack—, queremos lo mismo para ti: la alegría sencilla de hacer algo que funciona y esas pequeñas satisfacciones, bien reales, que solo se sienten cuando entiendes lo que haces mientras lo haces. Es más fácil encariñarse con un oficio cuando el manual no es, además, un obstáculo.

Lo que esto nos cuesta de verdad

Nada de esto es gratis, y no vamos a fingir lo contrario. Incluso apoyándonos en la traducción automática, cada idioma adicional supone un coste de mantenimiento grande y permanente, y un borrador hecho por una máquina no es más que la línea de salida. Pasar de “las palabras están traducidas” a “el artículo se entiende de verdad y se lee con naturalidad para alguien que piensa en este idioma” es un trabajo arduo y profundamente humano, y es algo en lo que volcamos un esfuerzo real. La buena documentación se mide con un nivel de calidad que incluye que su lector real pueda entenderla (ISO/IEC/IEEE 26514); para nosotros, ese listón no baja solo porque cambie el idioma de quien lee.

Así que, cuando una traducción funciona bien, tómala por lo que quiere ser: no una comodidad más, sino un pequeño gesto de cariño de un grupo de ingenieros hacia otro.

Una nota para quien esté leyendo

Vamos a ser sinceros: a lo largo de dieciocho idiomas, no todas las frases serán perfectas, y algunas páginas llegan antes a unos idiomas que a otros. Si un pasaje se lee forzado o suena mal en tu idioma, dínoslo: tratamos un defecto de documentación igual que cualquier otro defecto de ingeniería, no como un detalle cosmético de última hora. Así es como mejora.

Más que nada, esperamos que leas esto en el idioma en el que piensas, y que en algún punto de estas páginas el PDF acabe gustándote un poco más de lo que esperabas, y construir cosas, un poco más que esta mañana. Si este es tu primer encuentro serio con el PDF, o con PHP, bienvenido. Nosotros empezamos justo donde estás tú: con curiosidad, un poco al margen del centro de gravedad angloparlante, y contentos de encontrar un manual que por fin parecía hablarnos. Escribimos este para que pudiera hablarte a ti.

Relacionado

• La documentación como producto — la disciplina de calidad que hay detrás de esta documentación, de la que la localización es una parte.
• La empresa detrás de NextPDF — quiénes somos y por qué un producto comercial se convirtió en open core.
• Open core, sin bloqueos — el modelo de licencias que nos permite seguir invirtiendo en trabajo como este.