25분
기술 영어 필수 패턴 20개
Day 1: 영어 문서 공포증
기술 영어 필수 패턴 20개
영어 문서 독해: API 문서, GitHub, Stack Overflow > Day 1: 영어 문서 공포증
학습 목표
기술 문서에서 자주 나오는 표현 패턴을 익힌다 패턴을 보고 바로 의미를 파악할 수 있다
기술 영어는 패턴이다
문법 공부할 필요 없다. 자주 나오는 패턴만 외우면 된다.
설치/설정 패턴
| 영어 | 한국어 | 예시 |
|---|---|---|
| Install X using Y | Y로 X를 설치해라 | Install pandas using pip |
| Run the following command | 다음 명령어를 실행해라 | Run the following command: npm install |
| Make sure X is installed | X가 설치되어 있는지 확인해라 | Make sure Node.js is installed |
| Set X to Y | X를 Y로 설정해라 | Set timeout to 30 |
함수/API 패턴
| 영어 | 한국어 | 예시 |
|---|---|---|
| Returns X | X를 반환한다 | Returns the sum of two numbers |
| Takes X as argument | X를 인자로 받는다 | Takes a string as argument |
| Accepts X | X를 허용한다 | Accepts an optional callback |
| Raises X / Throws X | X 에러를 발생시킨다 | Raises ValueError if invalid |
| Defaults to X | 기본값은 X다 | Defaults to None |
조건 패턴
| 영어 | 한국어 | 예시 |
|---|---|---|
| If X, then Y | X면 Y해라 | If true, return early |
| When X happens | X가 발생하면 | When error occurs, log it |
| In case of X | X인 경우 | In case of failure, retry |
| Unless X | X가 아니면 | Unless specified, use default |
주의/경고 패턴
| 영어 | 한국어 | 예시 |
|---|---|---|
| Note: | 참고: | Note: This is experimental |
| Warning: | 경고: | Warning: This will delete data |
| Important: | 중요: | Important: Backup first |
| Deprecated | 더 이상 사용 안 함 | This function is deprecated |
| Required | 필수 | API key is required |
| Optional | 선택 | Timeout is optional |
실전 테스트
다음 문장을 해석해보자:
"Returns the parsed JSON object. Raises JSONDecodeError if the input is not valid JSON."
해석:
- Returns the parsed JSON object = 파싱된 JSON 객체를 반환한다
- Raises JSONDecodeError = JSONDecodeError를 발생시킨다
- if the input is not valid JSON = 입력이 유효한 JSON이 아니면
결론: JSON을 파싱해서 반환하는데, JSON이 잘못되면 에러난다.
이 정도만 읽을 수 있으면 API 문서 읽기 준비 완료.