W twoim własnym języku

W skrócie

Jeśli otworzyłeś tę dokumentację, zobaczyłeś ją w języku, który naprawdę czytasz — a nie tylko takim, który potrafisz rozszyfrować — i Twoim pierwszym odruchem było zerknąć po raz drugi, może przeczytać zdanie czy dwa choćby po to, by sprawdzić, czy płynnie się układają, to już się rozumiemy. To właśnie ten moment zawahania jest całym powodem, dla którego ta strona powstała. Jeśli czytasz to teraz w języku innym niż angielski, to dokładnie na to liczyliśmy.

Przestrzeń między rozumieniem a pokochaniem

Języki projektowania oprogramowania są zapisane po angielsku i dla większości inżynierów angielski podręcznik to najzwyklejsza rzecz pod słońcem. Przy odrobinie narzędzi da się z nim pracować bez przeszkód. Ale jeśli angielski nie jest Twoim pierwszym językiem, znasz to uczucie, że coś wciąż stoi między Tobą a tekstem — cienka, nieustająca warstwa tłumaczenia, które wykonujesz w głowie, raz czytając dokumentację, a potem znów, pisząc własną.

Znamy to, bo to również nasza codzienność. Jesteśmy inżynierami, dla których angielski nie jest pierwszym językiem — takimi, którzy przez lata czytali podręczniki po angielsku i po angielsku pisali dokumentację oraz kod. Dlatego ostrzej niż większość wyczuwamy różnicę między artykułem, który się po prostu czyta, a takim, który trzeba z mozołem rozgryźć. Po obu wyjdziesz poinformowany. Ale tylko po jednym wyjdziesz spokojny. Móc coś zrozumieć i móc to polubić to nie to samo — i to właśnie o tę różnicę chodzi w całym tym przedsięwzięciu.

Dlaczego osiemnaście języków

Kiedy przewijasz listę języków i naliczasz blisko dwadzieścia pozycji — a część z nich nie należy do tych najpowszechniejszych na świecie — to nie przypadek ani odhaczona rubryka. Są tam dlatego, że chcemy, żebyś to polubił: sam produkt i to, wokół czego został zbudowany. PDF to system oparty na regułach — przenośny format dokumentu zdefiniowany, aż po model obiektów i składnię, przez formalny standard (ISO 32000-2). Nas to po cichu fascynuje i chcielibyśmy, żeby zaczęło fascynować także Ciebie.

To także powód, dla którego część tych artykułów czyta się mniej jak sucha dokumentacja referencyjna, a bardziej jak przystępna opowieść o tym, jak PDF naprawdę działa. Jeśli któryś z nich wyjaśnia coś, o czym nigdy wcześniej nie słyszałeś — nie martw się ani przez chwilę. Nie chodzi tylko o Ciebie. Zanim sami usiedliśmy nad ISO 32000-2, też tego nie wiedzieliśmy. Strona, która uczy Cię czegoś nowego o tym formacie, w języku, w którym możesz się rozluźnić, to strona, która robi swoje.

Zwłaszcza dla Azji Południowo-Wschodniej

Najważniejsze języki świata były oczywistością. To, o co zadbaliśmy osobno, to języki Azji Południowo-Wschodniej — indonezyjski, tajski i wietnamski. Europa, obie Ameryki i Azja Północno-Wschodnia mają długie, głęboko zakorzenione kultury programistyczne i od dawna dorównującą im dokumentację. Azja Południowo-Wschodnia ma jedną z najszybciej rosnących scen programistycznych na świecie — a mimo to pierwszorzędna dokumentacja w rodzimym języku wciąż dociera tam zwykle na końcu. Nie chcieliśmy być kolejnym narzędziem, które traktuje ją po macoszemu.

A kimkolwiek jesteś — studentem, młodszym inżynierem przy pierwszym prawdziwym projekcie, niezależnym twórcą, zespołem wplatającym PDF w swój stos — życzymy Ci tego samego: zwyczajnej radości z tworzenia czegoś, co działa, i tych drobnych, prawdziwych satysfakcji, jakie daje wyłącznie rozumienie tego, co się robi, w trakcie samego robienia. Łatwiej zakochać się w rzemiośle, gdy podręcznik nie jest jednocześnie przeszkodą.

Ile nas to naprawdę kosztuje

Nic z tego nie jest za darmo i nie będziemy udawać, że jest inaczej. Nawet wspierając się tłumaczeniem maszynowym, każdy kolejny język to duży i nieustanny koszt utrzymania — a maszynowo przełożony szkic to dopiero linia startu. Droga od „słowa są przetłumaczone” do „artykuł jest naprawdę zrozumiały i czyta się naturalnie komuś, kto myśli w tym języku” to ciężka, ludzka praca — i obszar, w który wkładamy naprawdę wiele. Dobra dokumentacja podlega poprzeczce jakości, która obejmuje zrozumiałość dla jej rzeczywistego czytelnika (ISO/IEC/IEEE 26514); u nas ta poprzeczka nie opada tylko dlatego, że zmienił się język czytelnika.

Dlatego kiedy tłumaczenie się udaje, potraktuj je jako to, czym naprawdę ma być: nie jako udogodnienie dla wygody, lecz jako drobny gest troski jednej grupy inżynierów wobec drugiej.

Słowo do każdego, kto czyta

Będziemy szczerzy: przy osiemnastu językach nie każde zdanie będzie idealne, a niektóre strony docierają do jednych języków wcześniej niż do innych. Jeśli jakiś fragment brzmi w Twoim języku sztywno albo po prostu źle, daj nam znać — defekt dokumentacji traktujemy tak samo jak każdy inny defekt inżynierski, a nie jak kosmetyczny drobiazg na potem. To dzięki temu staje się ona lepsza.

A nade wszystko mamy nadzieję, że czytasz to w języku, w którym myślisz, i że gdzieś tutaj polubisz PDF trochę bardziej, niż się spodziewałeś, a tworzenie rzeczy — trochę bardziej niż jeszcze dziś rano. Jeśli to Twoje pierwsze poważne spotkanie z PDF albo z PHP — witaj. Zaczynaliśmy dokładnie tam, gdzie jesteś Ty: ciekawi, trochę z boku anglojęzycznego środka ciężkości i szczęśliwi, że znaleźliśmy podręcznik, który w końcu sprawiał wrażenie, jakby mówił do nas. Ten napisaliśmy tak, żeby mógł mówić do Ciebie.

Powiązana dokumentacja

• Dokumentacja jako produkt — dyscyplina jakości stojąca za tą dokumentacją, w której lokalizacja jest jednym z elementów.
• Firma stojąca za NextPDF — kim jesteśmy i dlaczego komercyjny produkt stał się otwartym rdzeniem (open core).
• Otwarty rdzeń, bez uwięzienia — model licencjonowania, dzięki któremu możemy dalej inwestować w pracę taką jak ta.