あなたの言葉で

ひと目で

このドキュメントを開いたとき、ただ解読できる言語ではなく、あなたが本当に読める言語で表示されているのを目にして、思わずもう一度見直した——もしかすると、文章がちゃんと流れているか確かめようと、一文か二文を読んでみた。もしそうなら、わたしたちはもう、わかり合えています。その「二度見」こそが、このページが存在する理由のすべてです。いま、あなたがこれを英語以外の言葉で読んでいるのなら、それはまさに、わたしたちが願っていたことなのです。

「わかる」と「好きになる」のあいだ

ソフトウェア設計の言語は英語で書かれていて、多くのエンジニアにとって、英語のマニュアルはごくあたりまえのものです。ちょっとした道具立てさえあれば、不自由なく使いこなせます。けれど、英語が母語でないなら、あの感覚に覚えがあるはずです——自分とページのあいだに、何かがまだ挟まっているという感覚。リファレンスを読むときに頭の中でそっと行い、自分のコードやドキュメントを書くときにもう一度くり返す、あの薄くて絶え間ない翻訳の層です。

それがわかるのは、それがわたしたち自身の感覚でもあるからです。わたしたちは英語を母語としないエンジニアで、英語のマニュアルを読み、英語でドキュメントとコードを書きながら、何年も過ごしてきました。だからこそ、ただ読むだけの記事と、理解しようと努力しなければならない記事とのあいだにある隔たりを、人一倍はっきりと感じます。どちらも、知識は残してくれます。けれど、安らぎまで残してくれるのは片方だけです。何かをわかることと、それを楽しめることは、同じではありません——そして、その違いこそが、この取り組みのすべての理由なのです。

なぜ18の言語なのか

言語の一覧をスクロールして、20近くもの項目を数えるとき——そのいくつかは、世界で最も広く使われている言語というわけでもありません——それは偶然ではありませんし、形式的にチェック項目を埋めているわけでもありません。それがそこにあるのは、わたしたちがあなたに、これを好きになってほしいからです。プロダクトそのものも、そしてそれが中心に据えているものも。PDF は、規則の上に築かれたシステムです——そのオブジェクトモデルや構文に至るまで、形式的な標準（ISO 32000-2）によって定義された、ポータブルなドキュメントフォーマットです。わたしたちはそれを、ひそかに面白いと感じていて、あなたにも同じように面白がってもらえたら、と願っています。

だからこそ、これらの記事のいくつかは、無味乾燥なリファレンスというより、PDF が実際どう動いているのかをめぐる親しみやすい物語のように読めるのです。もしそのどれかが、あなたの聞いたこともなかった何かを説明していたとしても——一瞬たりとも心配しないでください。あなただけではありません。わたしたち自身、腰を据えて ISO 32000-2 を読むまでは、やはり知りませんでした。あなたがくつろいで読める言葉で、このフォーマットについて何か新しいことを教えてくれるページは、ちゃんと役目を果たしているページなのです。

とりわけ、東南アジアのために

世界の主要な言語は、はじめから当然のものでした。わたしたちがあえて手間をかけて加えたのは、東南アジアの言語です——インドネシア語、タイ語、そしてベトナム語。ヨーロッパ、南北アメリカ、そして北東アジアには、長く深いソフトウェア文化があり、それに見合うドキュメントも、長らく整ってきました。東南アジアは、世界でも有数の、もっとも急速に伸びているソフトウェアの現場のひとつです——それなのに、母語で読める一級のドキュメントは、いまだに最後にようやく届く、という傾向があります。わたしたちは、そこを後回しにする、もう一つのツールにはなりたくなかったのです。

そしてあなたが誰であろうと——学生でも、はじめての本格的なプロジェクトに取り組む若手エンジニアでも、ひとりでものをつくる人でも、自分のスタックに PDF を組み込むチームでも——わたしたちが願うのは、あなたにとっても同じことです。動くものをつくる、あの素朴な喜び。そして、自分が何をしているのかを理解しながら手を動かすときにだけ得られる、小さくて確かな手ごたえ。マニュアルそのものが妨げにならないとき、人はその技に、ずっと惚れ込みやすくなるものです。

これが、わたしたちに実際どれだけのコストを強いているか

これはどれも、ただで手に入るものではありません——そして、そうでないふりをするつもりもありません。機械翻訳に頼ったとしても、言語をひとつ増やすたびに、それは大きく、終わりのない保守コストになります——機械翻訳の下書きは、ほんのスタートラインにすぎません。「言葉は訳されている」から、「記事が本当に理解でき、この言語で考える人にとって自然に読める」ところまでたどり着くのは、骨の折れる、人の手の仕事であり、わたしたちが本気で力を注いでいる領域です。よいドキュメントは、実際の読み手にとって理解できることを含む品質基準に照らして評価されます（ISO/IEC/IEEE 26514）。わたしたちにとって、その基準は、読み手の言語が変わったからといって、下がることはありません。

ですから、翻訳がうまく届いたときには、どうかそれを、本来そうあるべきものとして受け取ってください——便利機能としてではなく、あるエンジニアたちから、別のエンジニアたちへ向けた、ささやかな心づかいとして。

これを読んでいるあなたへ

正直に言います。18の言語すべてにわたって、どの文も完璧、というわけにはいかないでしょうし、あるページが、ある言語には先に、別の言語には遅れて届く、ということもあります。もしどこかの一節が、あなたの言語でぎこちなく、あるいは間違って読めたなら、どうか教えてください——わたしたちはドキュメントの不具合を、ほかのあらゆるエンジニアリングの不具合とまったく同じように扱います。見た目だけの、後回しにしてかまわないものとしては、決して扱いません。そうやって、よくなっていくのです。

何よりも願うのは、あなたがこれを、自分が考えるときの言語で読んでくれること。そして、このページのどこかで、思っていたより少しだけ PDF を好きになり、今朝より少しだけ、ものをつくることが好きになってくれること。もしこれが、あなたにとって PDF との、あるいは PHP との、はじめての本格的な出会いなら——ようこそ。わたしたちも、まさにあなたと同じ場所から始めました。好奇心を抱きながら、英語圏という重力の中心からは少しだけ外れたところにいて、ようやく自分たちに語りかけてくれているように感じられるマニュアルに出会えて、うれしかった。今度はそれが、あなたに語りかけられるように、わたしたちはこのページを書きました。