여러분의 언어로
한눈에 보기
섹션 제목: “한눈에 보기”이 문서를 열었을 때, 그저 해독해 내는 언어가 아니라 정말로 술술 읽히는 언어로 쓰여 있는 것을 보고, 문득 한 번 더 들여다보고 싶어졌다면 — 문장 한두 개를 읽어 보며 흐름이 자연스러운지 가만히 확인하고 싶어졌다면 — 우리는 이미 서로 통하고 있는 셈입니다. 바로 그 한 번 더 보게 되는 순간이야말로, 이 페이지가 존재하는 이유 그 자체입니다. 지금 여러분이 영어가 아닌 다른 언어로 이 글을 읽고 있다면, 그것이 바로 우리가 바라던 모습입니다.
이해하는 것과 사랑하는 것 사이의 거리
섹션 제목: “이해하는 것과 사랑하는 것 사이의 거리”소프트웨어 설계의 언어는 영어로 쓰여 있고, 대부분의 엔지니어에게 영어로 된 매뉴얼은 세상에서 가장 당연한 것입니다. 도구의 도움을 조금만 받으면 다루는 데 아무 문제가 없죠. 하지만 여러분의 모국어가 영어가 아니라면, 무언가가 여전히 여러분과 페이지 사이에 끼어 있는 그 느낌을 알 것입니다 — 참고 문서를 읽을 때도, 자신의 글을 쓸 때도, 머릿속에서 쉼 없이 돌아가는 얇고 한결같은 번역의 막 말입니다.
우리는 그 느낌을 압니다. 우리도 똑같이 겪고 있으니까요. 우리는 모국어가 영어가 아닌 엔지니어들이고, 영어로 된 매뉴얼을 읽고 영어로 문서와 코드를 쓰며 여러 해를 보냈습니다. 그래서 누구보다 또렷하게, 그저 읽히는 글과 애써 이해해야 하는 글 사이의 간극을 느낍니다. 둘 다 여러분에게 정보를 남겨 줄 수는 있습니다. 하지만 여러분을 편안하게 해 주는 것은 그중 하나뿐입니다. 무언가를 이해할 수 있다는 것과 그것을 즐길 수 있다는 것은 같지 않습니다 — 그리고 바로 그 차이가 이 모든 노력이 향하는 지점입니다.
왜 열여덟 개 언어인가
섹션 제목: “왜 열여덟 개 언어인가”언어 목록을 내리다가 스무 개에 가까운 항목을 세어 보게 될 때 — 그중 일부는 전 세계에서 가장 널리 쓰이는 언어가 아닐 때 — 그것은 우연도 아니고, 그저 형식적으로 채워 넣은 칸도 아닙니다. 그렇게 한 이유는, 우리가 여러분이 이것을 좋아하기를 바라기 때문입니다. 제품 그 자체도, 그리고 그 제품이 다루는 그 대상도 말입니다. PDF는 규칙 위에 세워진 시스템입니다 — 객체 모델과 구문에 이르기까지 형식을 갖춘 표준(ISO 32000-2)으로 정의된 이식 가능한 문서 형식이죠. 우리는 그 점이 조용히 매혹적이라고 느끼고, 여러분도 그렇게 느끼게 되기를 바랍니다.
바로 그래서, 이 글들 중 일부는 무미건조한 참고서라기보다 PDF가 실제로 어떻게 작동하는지에 관한 친근한 이야기처럼 읽힙니다. 그중 한 편이 여러분이 한 번도 들어 본 적 없는 무언가를 설명하더라도 — 단 한순간도 걱정하지 마세요. 여러분만 그런 게 아닙니다. 우리도 직접 자리에 앉아 ISO 32000-2를 읽기 전까지는 몰랐으니까요. 여러분이 마음 놓고 빠져들 수 있는 언어로 이 형식에 관한 새로운 무언가를 가르쳐 주는 페이지라면, 그것은 제 몫을 다하고 있는 페이지입니다.
특히 동남아시아를 위하여
섹션 제목: “특히 동남아시아를 위하여”세계의 주요 언어들은 두말할 것 없는 선택이었습니다. 우리가 일부러 마음을 써서 더한 것은 동남아시아의 언어들 — 인도네시아어, 태국어, 베트남어 — 였습니다. 유럽과 아메리카, 그리고 동북아시아에는 길고 깊은 소프트웨어 문화가 있었고, 그에 걸맞은 문서도 오래전부터 있었습니다. 동남아시아는 세계 어디에 견주어도 가장 빠르게 떠오르는 소프트웨어 무대 중 하나입니다 — 그런데도 일류 수준의 모국어 문서는 여전히 그곳에 가장 늦게 닿곤 합니다. 우리는 그곳을 뒷전으로 미루는 또 하나의 도구가 되고 싶지 않았습니다.
그리고 여러분이 누구든 — 학생이든, 첫 실무 프로젝트를 맡은 주니어 엔지니어든, 홀로 무언가를 만들어 가는 사람이든, PDF를 자신의 스택에 끼워 넣고 있는 팀이든 — 우리는 여러분 모두에게 같은 것을 바랍니다. 작동하는 무언가를 만들어 내는 순수한 기쁨, 그리고 무언가를 하는 동안 자신이 무엇을 하고 있는지 이해할 때에만 얻을 수 있는, 작지만 진짜인 만족 말입니다. 매뉴얼이 걸림돌까지 되지는 않을 때, 어떤 기술에 빠져드는 일은 한결 쉬워집니다.
이것이 우리에게 실제로 드는 비용
섹션 제목: “이것이 우리에게 실제로 드는 비용”이 모든 것은 공짜가 아니며, 우리는 아닌 척하지 않겠습니다. 기계 번역에 기대더라도, 언어를 하나 더 늘리는 일은 크고 끊임없이 이어지는 유지 비용입니다 — 그리고 기계가 뽑아낸 초안은 출발선일 뿐입니다. “단어가 번역되었다”에서 “이 글이 정말로 이해되고, 이 언어로 생각하는 사람에게 자연스럽게 읽힌다”까지 나아가는 일은 사람의 손이 드는 고된 작업이며, 우리가 진짜 힘을 쏟아붓는 영역입니다. 좋은 문서는 실제 독자가 이해할 수 있어야 한다는 점을 포함하는 품질 기준을 따릅니다(ISO/IEC/IEEE 26514). 우리에게 그 기준은 독자의 언어가 바뀌었다고 해서 낮아지지 않습니다.
그러니 어떤 번역이 잘 와닿을 때는, 그것을 본래 의도된 그대로 받아 주세요. 그저 편의 기능이 아니라, 한 무리의 엔지니어가 또 다른 엔지니어들에게 건네는 작은 마음 씀씀이로 말입니다.
읽고 계신 누군가에게 드리는 글
섹션 제목: “읽고 계신 누군가에게 드리는 글”솔직하게 말씀드리겠습니다. 열여덟 개 언어에 걸쳐 있다 보니, 모든 문장이 완벽하지는 않을 것이고, 어떤 페이지는 특정 언어에 다른 언어보다 먼저 닿기도 합니다. 어떤 구절이 여러분의 언어로 어색하거나 잘못 읽힌다면, 우리에게 알려주세요 — 우리는 문서의 결함을 여느 엔지니어링 결함과 똑같이 대하지, 나중에 슬쩍 손볼 겉치레쯤으로 여기지 않습니다. 그래야 더 나아지니까요.
무엇보다도, 우리는 여러분이 스스로 생각하는 그 언어로 이 글을 읽기를, 그리고 이 어딘가에서 기대했던 것보다 PDF를 조금 더 좋아하게 되기를, 또 오늘 아침보다 무언가를 만드는 일이 조금 더 즐거워지기를 바랍니다. 이것이 PDF와의, 혹은 PHP와의 여러분의 첫 진지한 만남이라면 — 환영합니다. 우리도 정확히 여러분이 지금 서 있는 그 자리에서 출발했습니다. 호기심에 차 있었고, 영어권의 중심에서 살짝 비켜나 있었으며, 마침내 우리에게 말을 걸어오는 듯한 매뉴얼을 만나 반가웠습니다. 우리는 이 매뉴얼이 이번엔 여러분에게 말을 걸 수 있도록 썼습니다.
관련 문서
섹션 제목: “관련 문서”- 제품으로서의 문서 — 이 문서들을 떠받치는 품질의 규율, 그 한 부분이 지역화입니다.
- NextPDF를 만든 회사 — 우리가 누구이며 상업 제품이 어떻게 오픈 코어가 되었는지에 관하여.
- 오픈 코어, 잠금 없음 — 이와 같은 작업에 계속 투자할 수 있게 해 주는 라이선스 모델.