읽기 가이드

영어 기술 문서를 효율적으로 읽는 법: 개발자를 위한 실전 방법

공식 문서, API 레퍼런스, GitHub 이슈, RFC는 대부분 영어로 쓰여 있고 번역본은 늦게 나오기 일쑤입니다. 영어 원문을 바로 읽을 수 있다는 것은 개발자에게 매우 실용적인 능력입니다. 다행히 기술 영어는 문학 영어보다 훨씬 규칙적입니다.

기술 문서를 페이지 번역하면 곤란한 이유

  • 용어가 잘못 번역됩니다: promise, thread, handle, token 같은 단어는 기술적으로 정확한 의미가 있지만, 기계 번역은 일상적인 뜻으로 옮기기 쉽습니다.
  • 코드가 망가집니다: 번역 과정에서 코드 블록, 함수 이름, 설정 키가 바뀌어 복사한 예제가 작동하지 않을 수 있습니다.
  • 검색어를 잃습니다: 오류 메시지, API 이름, 커뮤니티 토론은 영어입니다. 번역어만 기억하면 문제가 생겼을 때 무엇으로 검색해야 할지 모릅니다.

원문은 그대로 두고, 정말 막히는 일반 어휘에만 도움을 받는 편이 좋습니다.

1단계: 문장보다 구조를 먼저 읽기

기술 문서에는 정해진 틀이 있습니다. 먼저 제목, 목차, 코드 예제, 매개변수 표를 훑어보며 이 페이지가 무엇을 해결하는지 파악한 다음, 관련 문단을 꼼꼼히 읽으세요. 코드 예제와 매개변수 설명만으로 충분한 경우도 많습니다.

2단계: 전문 용어와 일반 어휘 구분하기

막히는 단어는 보통 두 종류로 나뉩니다.

  • 전문 용어: idempotent, serialization, middleware 등. 영어 용어와 기술적 의미를 함께 익히고, 굳이 한국어 번역어를 맞출 필요는 없습니다.
  • 일반 어휘: mitigate, leverage, arbitrary, subsequent 등. 온갖 문서에 반복해서 나오므로 한 번 익혀 두면 오래도록 도움이 됩니다.

읽기 어려운 진짜 원인은 후자인 경우가 많고, 문장 속 힌트로 빠르게 채울 수 있는 것도 바로 이쪽입니다.

3단계: 문서에 자주 나오는 표현 익히기

기술 문서는 정해진 표현을 반복해서 씁니다. 익숙해지면 읽는 속도가 눈에 띄게 빨라집니다.

  • deprecated: 사용 중단 예정. 향후 버전에서 제거될 수 있음.
  • under the hood: 내부 구현에서는.
  • out of the box: 추가 설정 없이 바로 사용 가능.
  • backward compatible: 하위 호환됨.
  • is not guaranteed: 보장되지 않음. 그 동작에 의존하면 위험함.
  • caveat: 주의해야 할 제한이나 예외.

4단계: 휴대폰으로 읽을 때도 앱을 오가지 않기

출퇴근길에 iPhone으로 문서를 읽는 일은 흔하지만, 단어마다 사전 앱을 오가면 집중이 끊깁니다. Safari에서 문장 속 힌트 확장 프로그램을 쓰면 어려운 단어 바로 위에 뜻이 표시되고, 코드와 영어 용어는 그대로 남습니다.

WordHint는 읽기 레벨보다 어려운 단어에만 힌트를 붙입니다. 기술 문서를 읽을 때는 레벨을 조금 높게 설정해 정말 드문 단어에만 힌트가 붙게 하고, 반복해서 나오는 일반 단어는 외운 단어로 표시하면 페이지가 점점 깔끔해집니다.

5단계: 읽기를 어휘로 이어 가기

  1. 문서에서 만났지만 잘 외워지지 않는 일반 단어를 저장합니다.
  2. 며칠에 한 번 예문과 읽어 주기로 복습합니다.
  3. 시간이 지나면 같은 종류의 문서에서 찾아볼 단어가 줄어드는 것을 느끼게 됩니다.

기술 영어의 어휘는 한정되어 있습니다. 몇 달 동안 영어 원문 문서를 꾸준히 읽으면 흔한 문서 대부분을 수월하게 읽을 수 있게 됩니다.

Safari 안에서 바로 단어 뜻 확인하기

WordHint는 지금 읽고 있는 영어 페이지의 어려운 단어 위에 간결한 한국어 뜻을 표시합니다. A1–C2 레벨에 맞춰 필요한 단어만. 무료로 다운로드할 수 있고, 오프라인으로 작동하며, 계정도 필요 없습니다.

App Store에서 무료 다운로드