In Ihrer eigenen Sprache

Auf einen Blick

Wenn Sie diese Dokumentation geöffnet haben, sie in einer Sprache vor sich hatten, die Sie wirklich lesen — nicht nur entziffern — und Ihr erster Impuls war, ein zweites Mal hinzuschauen, vielleicht ein, zwei Sätze zu lesen, nur um zu prüfen, ob sie sich flüssig lesen: dann verstehen wir uns schon. Genau dieser kurze Moment des Stutzens ist der eigentliche Grund, warum es diese Seite gibt. Wenn Sie das hier gerade in einer anderen Sprache als Englisch lesen, dann ist genau das eingetreten, worauf wir gehofft haben.

Der Raum zwischen Verstehen und Lieben

Die Sprachen des Software-Designs sind in Englisch geschrieben, und für die meisten Ingenieure ist ein englisches Handbuch das Selbstverständlichste der Welt. Mit etwas Übung lässt sich damit bestens arbeiten. Doch wenn Ihre Muttersprache nicht Englisch ist, kennen Sie das Gefühl, dass immer noch etwas zwischen Ihnen und der Seite steht — eine dünne, beständige Schicht aus Übersetzung, die Sie im Kopf vornehmen, während Sie die Referenz lesen, und noch einmal, während Sie Ihre eigene schreiben.

Wir kennen es, weil es auch unseres ist. Wir sind Ingenieure, deren Muttersprache nicht Englisch ist und die jahrelang Handbücher auf Englisch gelesen und Dokumentation und Code auf Englisch geschrieben haben. Deshalb spüren wir schärfer als die meisten den Unterschied zwischen einem Artikel, den man einfach liest, und einem, den man sich erst erarbeiten muss. Beide können Sie gut informiert zurücklassen. Aber nur der eine lässt Sie dabei gelassen. Etwas verstehen zu können und es genießen zu können, ist nicht dasselbe — und um genau diesen Unterschied geht es bei diesem ganzen Vorhaben.

Warum achtzehn Sprachen

Wenn Sie die Sprachliste durchscrollen und an die zwanzig Einträge zählen — manche davon nicht gerade die global dominantesten Sprachen — dann ist das kein Zufall und kein Häkchen, das pflichtschuldig gesetzt wird. Es ist so, weil wir möchten, dass Sie das hier mögen: das Produkt selbst und das, worum herum es gebaut ist. PDF ist ein System, das auf Regeln fußt — ein portables Dokumentformat, das bis hinunter zu seinem Objektmodell und seiner Syntax durch einen formalen Standard definiert ist (ISO 32000-2). Wir finden das auf eine stille Weise faszinierend, und wir würden uns wünschen, dass es Ihnen genauso geht.

Das ist auch der Grund, warum sich manche dieser Artikel weniger wie eine trockene Referenz lesen und mehr wie eine zugängliche Geschichte darüber, wie PDF tatsächlich funktioniert. Wenn einer davon Ihnen etwas erklärt, von dem Sie noch nie gehört haben — machen Sie sich keine Sekunde lang Sorgen. Es liegt nicht nur an Ihnen. Bevor wir uns hingesetzt und ISO 32000-2 selbst gelesen haben, wussten wir es nämlich auch nicht. Eine Seite, die Ihnen etwas Neues über das Format beibringt, in einer Sprache, in der Sie sich entspannen können, ist eine Seite, die ihre Aufgabe erfüllt.

Besonders für Südostasien

Die großen Weltsprachen waren eine Selbstverständlichkeit. Wofür wir uns besonders ins Zeug gelegt haben, waren die südostasiatischen — Indonesisch, Thailändisch und Vietnamesisch. Europa, Amerika und Nordostasien haben lange, tief verwurzelte Software-Kulturen und seit jeher eine Dokumentation, die dazu passt. Südostasien hat eine der am schnellsten wachsenden Software-Szenen überhaupt — und doch erreicht erstklassige muttersprachliche Dokumentation die Region noch immer meist zuletzt. Wir wollten nicht noch ein Werkzeug sein, das sie als nachträglichen Einfall behandelt.

Und wer auch immer Sie sind — eine Studentin, ein Junior-Entwickler im ersten echten Projekt, ein unabhängiger Tüftler, ein Team, das PDF in seinen Stack einbaut — wir wünschen Ihnen dasselbe: die schlichte Freude, etwas zu bauen, das funktioniert, und die kleinen, echten Glücksmomente, die sich nur einstellen, wenn man versteht, was man tut, während man es tut. Es fällt leichter, sich für ein Handwerk zu begeistern, wenn das Handbuch nicht selbst zum Hindernis wird.

Was uns das tatsächlich kostet

Nichts davon ist umsonst, und wir werden nicht so tun, als wäre es das. Selbst mit der Hilfe maschineller Übersetzung ist jede zusätzliche Sprache ein großer und fortlaufender Wartungsaufwand — und ein maschinell übersetzter Entwurf ist nur die Startlinie. Von „die Wörter sind übersetzt” bis zu „der Artikel ist wirklich verständlich und liest sich natürlich für jemanden, der in dieser Sprache denkt” zu kommen, ist harte, menschliche Arbeit, und in diesen Bereich stecken wir echte Mühe. Gute Dokumentation wird an einem Qualitätsmaßstab gemessen, der auch die Verständlichkeit für ihre tatsächlichen Leser einschließt (ISO/IEC/IEEE 26514); und für uns verschiebt sich dieser Maßstab nicht, nur weil sich die Sprache des Lesers geändert hat.

Wenn also eine Übersetzung gut gelingt, dann nehmen Sie sie bitte als das, was sie sein soll: keine Komfortfunktion, sondern eine kleine Geste der Fürsorge von einer Gruppe Ingenieure an eine andere.

Eine Notiz an alle, die das lesen

Wir sind ehrlich: Über achtzehn Sprachen hinweg wird nicht jeder Satz perfekt sein, und manche Seiten erreichen die eine Sprache früher als die andere. Wenn eine Passage in Ihrer Sprache steif oder falsch klingt, sagen Sie es uns — wir behandeln einen Mangel in der Dokumentation so, wie wir jeden anderen Engineering-Mangel behandeln, und nicht als kosmetische Nebensache. Genau so wird sie besser.

Mehr als alles andere hoffen wir, dass Sie dies in der Sprache lesen, in der Sie denken, und dass Sie PDF irgendwo hier ein wenig mehr liebgewinnen, als Sie es erwartet hätten — und das Bauen von Dingen ein wenig mehr als noch heute Morgen. Wenn dies Ihre erste ernsthafte Begegnung mit PDF ist oder mit PHP — willkommen. Wir haben genau dort angefangen, wo Sie jetzt stehen: neugierig, ein Stück weit außerhalb des englischsprachigen Schwerpunkts und froh, endlich ein Handbuch zu finden, das sich anfühlte, als spräche es zu uns. Dieses hier haben wir geschrieben, damit es zu Ihnen sprechen kann.

Verwandt

• Dokumentation als Produkt — die Qualitätsdisziplin hinter dieser Dokumentation, von der Lokalisierung ein Teil ist.
• Das Unternehmen hinter NextPDF — wer wir sind und warum aus einem kommerziellen Produkt Open Core wurde.
• Open Core, kein Lock-in — das Lizenzmodell, das es uns erlaubt, weiterhin in Arbeit wie diese zu investieren.