Na sua própria língua

Em resumo

Se você abriu esta documentação, viu que estava numa língua que você de fato lê — não apenas uma que você consegue decifrar — e seu primeiro impulso foi olhar de novo, talvez ler uma ou duas frases só para conferir se fluem, então já nos entendemos. É por causa desse impulso de olhar duas vezes que esta página existe. Se você está lendo isto agora em uma língua que não é o inglês, é exatamente o que a gente esperava.

O espaço entre entender e amar

As línguas do design de software são escritas em inglês, e para a maioria dos engenheiros um manual em inglês é a coisa mais natural do mundo. Com um pouco de ferramental, dá para trabalhar sem grandes problemas. Mas, se a sua primeira língua não é o inglês, você conhece aquela sensação de que algo ainda fica entre você e a página — uma fina camada constante de tradução que você faz na própria cabeça enquanto lê a referência, e de novo enquanto escreve a sua.

Nós sabemos disso porque também é a nossa realidade. Somos engenheiros cuja primeira língua não é o inglês, que passaram anos lendo manuais em inglês e escrevendo docs e código em inglês. Por isso sentimos, com mais nitidez do que a maioria, a distância entre um artigo que você simplesmente lê e um que você precisa decifrar com esforço. Os dois podem deixar você informado. Só um deixa você à vontade. Conseguir entender algo e conseguir apreciá-lo não são a mesma coisa — e é justamente dessa diferença que todo este esforço trata.

Por que dezoito línguas

Quando você percorre a lista de idiomas e conta perto de vinte entradas — algumas delas nem sendo as línguas mais dominantes do mundo —, isso não é por acaso, e não é só marcar uma caixinha. Está aí porque queremos que você goste disto: do produto em si e daquilo em torno do qual ele foi construído. O PDF é um sistema construído sobre regras — um formato de documento portátil definido, até o seu modelo de objetos e a sua sintaxe, por um padrão formal (ISO 32000-2). Achamos isso fascinante de um jeito discreto, e gostaríamos que você achasse fascinante também.

É também por isso que alguns destes artigos se leem menos como uma referência árida e mais como uma história acessível sobre como o PDF realmente funciona. Se um deles explicar algo de que você nunca tinha ouvido falar — não se preocupe nem um pouco. Não é só você. Antes de sentarmos e lermos a ISO 32000-2 por conta própria, a gente também não sabia. Uma página que te ensina algo novo sobre o formato, numa língua em que você consegue relaxar, é uma página cumprindo o seu papel.

Em especial para o Sudeste Asiático

As grandes línguas mundiais eram garantidas. O que fizemos questão de acrescentar foram as do Sudeste Asiático — indonésio, tailandês e vietnamita. A Europa, as Américas e o Nordeste Asiático têm culturas de software longas e profundas, e há muito tempo têm documentação à altura. O Sudeste Asiático tem uma das cenas de software que mais crescem no mundo inteiro — e, mesmo assim, uma documentação de primeira linha na língua nativa ainda costuma chegar lá por último. Não queríamos ser mais uma ferramenta que o trata como algo secundário.

E quem quer que você seja — um estudante, um engenheiro júnior no seu primeiro projeto de verdade, alguém que constrói por conta própria, um time encaixando PDF na sua stack —, queremos a mesma coisa para você: a alegria simples de fazer algo que funciona, e aquelas pequenas satisfações concretas que só vêm de entender o que você está fazendo enquanto faz. É mais fácil se apaixonar por um ofício quando o manual não é, ele mesmo, mais um obstáculo.

O que isto de fato nos custa

Nada disto é de graça, e não vamos fingir que seja. Mesmo nos apoiando em tradução de máquina, cada língua a mais é um custo de manutenção grande e contínuo — e um rascunho traduzido por máquina é apenas a linha de largada. Sair de “as palavras estão traduzidas” e chegar a “o artigo é genuinamente compreensível e soa natural para quem pensa nesta língua” é um trabalho humano e difícil, e é uma frente na qual investimos esforço de verdade. Uma boa documentação é avaliada por um padrão de qualidade que inclui ser compreensível para quem de fato a lê (ISO/IEC/IEEE 26514); para nós, esse padrão não baixa só porque a língua do leitor mudou.

Então, quando uma tradução acerta o tom, receba-a, por favor, como ela quer ser recebida: não como um recurso de conveniência, mas como um pequeno gesto de cuidado de um grupo de engenheiros para outro.

Um recado para quem estiver lendo

Vamos ser honestos: entre dezoito línguas, nem toda frase vai sair perfeita, e algumas páginas chegam a certas línguas antes de outras. Se um trecho soar duro ou errado na sua língua, nos avise — tratamos um defeito de documentação como tratamos qualquer outro defeito de engenharia, e não como um detalhe cosmético deixado para depois. É assim que a coisa melhora.

Mais do que tudo, esperamos que você leia isto na língua em que pensa, e que, em algum ponto por aqui, passe a gostar de PDF um pouco mais do que esperava, e de construir coisas um pouco mais do que gostava hoje de manhã. Se este é o seu primeiro encontro sério com PDF, ou com PHP — seja bem-vindo. Começamos exatamente onde você está: curiosos, um pouco fora do centro de gravidade do mundo de língua inglesa, e felizes de encontrar um manual que enfim parecia estar falando com a gente. Escrevemos este aqui para que ele pudesse falar com você.

Documentação relacionada

• Documentação como produto — a disciplina de qualidade por trás destes documentos, da qual a localização é uma parte.
• A empresa por trás do NextPDF — quem somos e por que um produto comercial se tornou núcleo aberto.
• Núcleo aberto, sem lock-in — o modelo de licenciamento que nos permite seguir investindo em trabalho como este.