In je eigen taal

In het kort

Als je deze documentatie opende, ze zag in een taal die je echt leest — niet alleen een taal die je kunt ontcijferen — en je eerste reflex was om nog eens goed te kijken, misschien een zin of twee te lezen om te checken of het lekker loopt, dan begrijpen we elkaar nu al. Die dubbele blik is precies de reden dat deze pagina bestaat. Lees je dit op dit moment in een andere taal dan het Engels, dan is dat precies waar we op hoopten.

De ruimte tussen begrijpen en ervan houden

De talen van softwareontwerp zijn in het Engels geschreven, en voor de meeste engineers is een Engelse handleiding de gewoonste zaak van de wereld. Met de juiste tooling is het prima werkbaar. Maar als je moedertaal niet Engels is, ken je dat gevoel dat er nog altijd iets tussen jou en de pagina in blijft hangen — een dunne, constante laag vertaling die je in je hoofd legt terwijl je de referentie leest, en nog eens terwijl je je eigen tekst schrijft.

Wij kennen dat gevoel, want het is ook van ons. Wij zijn engineers wier moedertaal niet Engels is, die jarenlang handleidingen in het Engels hebben gelezen en documentatie en code in het Engels hebben geschreven. Daarom voelen we, scherper dan de meesten, het verschil tussen een artikel dat je gewoon leest en een dat je moet ontcijferen om te begrijpen. Allebei kunnen ze je goed informeren. Maar slechts één van de twee stelt je op je gemak. Iets kunnen begrijpen en er echt van kunnen genieten zijn niet hetzelfde — en om precies dat verschil draait deze hele inspanning.

Waarom achttien talen

Als je door de talenlijst scrolt en bijna twintig vermeldingen telt — waarvan sommige niet de meest dominante talen ter wereld zijn — dan is dat geen toeval, en ook geen hokje dat even wordt afgevinkt. Het staat er omdat we willen dat je dit leuk gaat vinden: het product zelf, én datgene waar het omheen is gebouwd. PDF is een systeem dat op regels berust — een portable document format dat, tot in zijn objectmodel en syntaxis, wordt gedefinieerd door een formele standaard (ISO 32000-2). Wij vinden dat stiekem fascinerend, en we hopen dat jij het ook fascinerend gaat vinden.

Daarom lezen sommige van deze artikelen ook minder als een droge referentie en meer als een toegankelijk verhaal over hoe PDF nu eigenlijk werkt. Legt een van die artikelen iets uit waar je nog nooit van had gehoord — maak je dan geen seconde zorgen. Je bent niet de enige. Voordat we ISO 32000-2 er zelf bij pakten en gingen lezen, wisten wij het ook niet. Een pagina die je iets nieuws over het format leert, in taal waarin je tot rust kunt komen, is een pagina die haar werk doet.

Speciaal voor Zuidoost-Azië

De grote wereldtalen spraken voor zich. Waar we bewust extra moeite voor hebben gedaan, waren de Zuidoost-Aziatische talen — Indonesisch, Thais en Vietnamees. Europa, Amerika en Noordoost-Azië hebben lange, diepgewortelde softwareculturen, en al even lang de documentatie die daarbij hoort. Zuidoost-Azië heeft een van de snelst opkomende softwarescènes ter wereld — en tóch bereikt eersteklas documentatie in de eigen taal die regio nog steeds als laatste. We wilden niet zomaar nóg een tool zijn die haar als bijzaak behandelt.

En wie je ook bent — een student, een junior engineer op een eerste echt project, een onafhankelijke bouwer, een team dat PDF in zijn stack inpast — we wensen jou hetzelfde toe: het pure plezier van iets maken dat werkt, en die kleine, echte voldoening die je alleen krijgt door te begrijpen wat je doet terwijl je het doet. Het is een stuk makkelijker om voor een vak te vallen als de handleiding niet óók nog een obstakel is.

Wat ons dit echt kost

Niets hiervan is gratis, en we gaan niet doen alsof. Zelfs met machinevertaling als steun is elke extra taal een grote en blijvende onderhoudslast — en een machinevertaalde versie is niet meer dan de startstreep. Van “de woorden zijn vertaald” naar “het artikel is echt begrijpelijk, en leest natuurlijk voor iemand die in deze taal denkt” is zwaar, menselijk werk, en juist daar steken we echte energie in. Goede documentatie wordt afgemeten aan een kwaliteitsnorm die ook inhoudt dat de daadwerkelijke lezer haar begrijpt (ISO/IEC/IEEE 26514); en die lat leggen wij niet lager, enkel omdat de taal van de lezer veranderde.

Dus als een vertaling goed bij je binnenkomt, neem het dan voor wat het bedoeld is te zijn: geen handige extra, maar een kleine blijk van zorg van de ene groep engineers voor de andere.

Een woord aan wie dit leest

Eerlijk is eerlijk: verspreid over achttien talen zal niet elke zin perfect zijn, en sommige pagina’s bereiken de ene taal eerder dan de andere. Leest een passage stug of fout in jouw taal, laat het ons dan weten — we behandelen een documentatiedefect net zoals elk ander engineeringdefect, niet als een cosmetische bijzaak. Zo wordt het beter.

Bovenal hopen we dat je dit leest in de taal waarin je denkt, en dat je ergens hierin PDF iets meer gaat waarderen dan je had verwacht, en het bouwen van dingen iets meer dan vanochtend. Is dit je eerste serieuze kennismaking met PDF, of met PHP — welkom. Wij begonnen precies waar jij nu staat: nieuwsgierig, net buiten het Engelstalige zwaartepunt, en blij dat we een handleiding vonden die eindelijk het gevoel gaf dat ze tegen óns sprak. Deze schreven we, zodat ze tegen jóu kan spreken.

Verwant

• Documentatie als product — de kwaliteitsdiscipline achter deze documentatie, waarvan lokalisatie één onderdeel is.
• Het bedrijf achter NextPDF — wie we zijn en waarom een commercieel product open core werd.
• Open core, geen lock-in — het licentiemodel dat ons in staat stelt te blijven investeren in werk als dit.