Nella tua lingua

In breve

Se hai aperto questa documentazione, l’hai vista in una lingua che leggi davvero — non semplicemente una che riesci a decifrare — e il tuo primo istinto è stato di guardarla due volte, magari di leggere una frase o due solo per controllare se scorrono, allora ci siamo già capiti. È proprio per quel secondo sguardo che questa pagina esiste. E se in questo momento la stai leggendo in una lingua diversa dall’inglese, è esattamente quello che speravamo.

Lo spazio tra capire e amare

I linguaggi con cui si progetta il software sono scritti in inglese, e per la maggior parte degli ingegneri un manuale in inglese è la cosa più naturale del mondo. Con qualche strumento a portata di mano, ci si lavora benissimo. Ma se la tua lingua madre non è l’inglese, conosci quella sensazione di qualcosa che resta comunque in mezzo tra te e la pagina — un sottile, costante velo di traduzione che fai dentro la testa mentre leggi il riferimento, e di nuovo mentre scrivi il tuo.

Lo sappiamo perché è anche la nostra. Siamo ingegneri la cui lingua madre non è l’inglese, che hanno passato anni a leggere manuali in inglese e a scrivere documentazione e codice in inglese. Per questo avvertiamo, più nettamente di molti, la distanza tra un articolo che semplicemente leggi e uno che devi sforzarti di capire. Entrambi possono lasciarti informato. Solo uno ti lascia a tuo agio. Riuscire a capire qualcosa e riuscire a goderselo non sono la stessa cosa — ed è proprio questa differenza il senso di tutto questo lavoro.

Perché diciotto lingue

Quando scorri l’elenco delle lingue e conti quasi venti voci — alcune delle quali non certo tra le più diffuse al mondo — non è un caso, e non è una casella da spuntare. Sono lì perché vogliamo che tutto questo ti piaccia: il prodotto in sé, e ciò attorno a cui è costruito. Il PDF è un sistema fondato su regole — un formato di documento portatile definito, fin nel suo modello a oggetti e nella sua sintassi, da uno standard formale (ISO 32000-2). Lo troviamo, in silenzio, affascinante, e ci piacerebbe che affascinasse anche te.

È anche per questo che alcuni di questi articoli si leggono meno come un arido riferimento e più come un racconto accessibile di come funziona davvero il PDF. Se uno di essi ti spiega qualcosa di cui non avevi mai sentito parlare — non preoccuparti nemmeno per un istante. Non sei l’unico. Prima di metterci a leggere noi stessi ISO 32000-2, non lo sapevamo neanche noi. Una pagina che ti insegna qualcosa di nuovo sul formato, in un linguaggio in cui puoi distenderti, è una pagina che fa il suo lavoro.

Soprattutto per il Sud-est asiatico

Le grandi lingue del mondo erano un punto di partenza ovvio. Quelle che abbiamo voluto aggiungere a ogni costo erano le lingue del Sud-est asiatico — indonesiano, thailandese e vietnamita. L’Europa, le Americhe e l’Asia nordorientale hanno culture del software lunghe e radicate, e da tempo una documentazione all’altezza. Il Sud-est asiatico ha una delle scene del software in più rapida crescita al mondo — eppure una documentazione di prima qualità nella lingua madre tende ancora ad arrivarvi per ultima. Non volevamo essere l’ennesimo strumento che la considera un ripensamento.

E chiunque tu sia — uno studente, un ingegnere alle prime armi al suo primo progetto vero, uno sviluppatore indipendente, un team che sta integrando il PDF nel proprio stack — desideriamo la stessa cosa per te: la pura gioia di costruire qualcosa che funziona, e le piccole, autentiche soddisfazioni che arrivano solo dal capire ciò che fai mentre lo fai. È più facile appassionarsi a un mestiere quando il manuale non è a sua volta un ostacolo.

Quanto ci costa davvero

Niente di tutto questo è gratis, e non fingeremo il contrario. Anche appoggiandoci alla traduzione automatica, ogni lingua in più è un costo di manutenzione ampio e continuo — e una bozza tradotta a macchina è solo la linea di partenza. Passare da “le parole sono tradotte” a “l’articolo è davvero comprensibile, e suona naturale a chi pensa in questa lingua” è un lavoro difficile e umano, ed è un aspetto in cui investiamo impegno vero. Una buona documentazione deve rispettare uno standard di qualità che comprende l’essere comprensibile per chi la legge davvero (ISO/IEC/IEEE 26514); e per noi quello standard non si abbassa solo perché è cambiata la lingua del lettore.

Perciò, quando una traduzione riesce bene, prendila per ciò che vuole essere: non una funzione pensata per comodità, ma un piccolo gesto di cura da un gruppo di ingegneri a un altro.

Una nota a chiunque stia leggendo

Saremo onesti: tra diciotto lingue, non ogni frase sarà perfetta, e alcune pagine raggiungono certe lingue prima di altre. Se un passaggio ti suona rigido o sbagliato nella tua lingua, faccelo sapere — un difetto nella documentazione lo trattiamo come qualunque altro difetto di ingegneria, non come un dettaglio estetico da rimandare. È così che migliora.

Più di ogni altra cosa, speriamo che tu legga queste pagine nella lingua in cui pensi, e che da qualche parte, qui dentro, il PDF finisca per piacerti un po’ più di quanto ti aspettassi, e il costruire cose un po’ più di quanto ti piacesse stamattina. Se questo è il tuo primo incontro serio con il PDF, o con il PHP — benvenuto. Noi siamo partiti esattamente da dove sei tu: curiosi, un po’ fuori dal centro di gravità del mondo anglofono, e felici di trovare finalmente un manuale che sembrava parlare proprio a noi. Questo l’abbiamo scritto perché potesse parlare a te.

Correlati

• La documentazione come prodotto — la disciplina di qualità dietro questa documentazione, di cui la localizzazione è solo una parte.
• L’azienda dietro NextPDF — chi siamo e perché un prodotto commerciale è diventato open core.
• Open core, nessun lock-in — il modello di licenza che ci consente di continuare a investire in un lavoro come questo.