결제 버그가 운영 환경에서만 난다. 스테이징에서도 로컬에서도 재현되지 않는다. 장애 채널에 "운영에서만 발생하고 로컬에서는 재현이 안 됩니다"라고 영어로 남기려는데, '운영에서'의 '-에서'를 in으로 옮길지 on이나 at으로 옮길지 손이 멈춘다. 한국어 '-에서' 하나가 영어에서는 여러 전치사(preposition)로 갈린다.
| 용어 | 뜻 |
|---|---|
| 명사(noun) | 사람·물건·장소·때의 이름. 예: The repo has a README.의 repo, README |
| 전치사(preposition) | 명사 앞에 붙어, 그 명사가 문장의 다른 말과 어떤 관계인지(어디, 언제, 어디로) 알려 주는 짧은 말. 예: I got a message from the CI bot.의 from |
| 장소 전치사(prepositions of place) | 무엇이 어디에 있는지 말하는 전치사. 예: The config file is next to the README.의 next to |
| 시간 전치사(prepositions of time) | 일이 언제 일어나는지 말하는 전치사. 예: Let's sync after lunch.의 after |
장애 채널에 남길 문장으로 맞는 것은?
"The bug only happens ___ production. I can't reproduce it locally."
규칙: 안에 있나, 위에 있나, 어디로 가나
A. 담긴 곳은 in, 줄과 면 위는 on. British Council은 장소 전치사를 설명하며 in을 더 큰 공간 안의 위치에, on을 표면 위의 위치와 길·강·경계 같은 선 위의 위치에 쓴다고 설명한다(British Council: Prepositions of place). 개발 글의 전치사는 이 그림에 맞춰 외워 두면 편하다. 다만 아래 구분은 British Council의 설명이 아니라 이 책의 기억법이다. 파일·함수·저장소·로그·환경은 무언가가 담긴 곳이라 in, 코드의 줄과 브랜치는 선이라 on, GitHub·Slack 같은 서비스는 그 위에 올리는 곳이라 on이다. GitHub 문서도 on GitHub, on your local branch라고 쓴다(GitHub Docs: Commenting on a pull request, Pushing commits to a remote repository).
The error is thrown in this function, on line 42.It's in the repo, but not on GitHub yet.I'm on main right now./The fix is on the hotfix branch.I see the same error in the logs.
B. 옮겨 가는 곳은 to, 합쳐 들어가는 곳은 into. 배포·푸시처럼 어딘가로 보내면 to, 다른 브랜치 안으로 합치면 into를 쓴다. 이것도 기억법이지만 문서의 쓰임과 맞는다. GitHub 문서는 푸시를 "push commits … to a remote repository"로, 머지 안내 첫 줄을 "Merge pull requests into the upstream branch"로 쓴다(GitHub Docs: Pushing commits to a remote repository, Merging a pull request). 보낸 뒤 그곳에 있는 상태를 말할 때는 다시 A로 돌아가 in production이 된다.
Deploy it to production.→It's in production now.Merge the hotfix into main.→The fix is on main.Push the branch to origin.
C. 시각은 at, 요일·날짜는 on, 하루 중 때는 in. British Council은 시간 전치사를 설명하며 at을 시각에, on을 요일과 날짜에, in을 in the morning처럼 하루의 일부와 월·연도에 쓴다고 정리한다(British Council: Prepositions of time). 요일과 하루 중 때가 같이 오면 요일 쪽을 따라 on Monday morning이다. Cambridge는 같은 경우를 on Tuesday afternoon으로 예를 든다(Cambridge Dictionary: Prepositions: afternoon).
The deploy is at 3 p.m.We'll release it on Monday./on October 20I'll pick it up in the morning.(pick up: 일을 맡아 손대기 시작하다)
D. 마감은 by, 계속되는 끝은 until. by Friday는 '금요일까지는 (그 전에 언제든) 끝낸다', until Friday는 '금요일까지 계속한다'는 뜻이다. Cambridge는 until을 'up to (the time that)', 곧 그 시점에 이를 때까지로 풀고, 정해진 때나 마감 전에 일어날 일에는 until이 아니라 by를 쓴다고 설명한다(Cambridge Dictionary: Until). 다만 You have until Friday to finish it.처럼 마감을 말하는 관용 표현에도 until이 쓰인다(VOA Learning English: up to, until, till).
Please review the PR by Friday.(금요일 전에 언제든 한 번)The feature flag stays on until Friday.(금요일까지 켜 둔다)The code freeze lasts until the release.
표현: 개발 장면별 전치사
| 표현 | 언제 | 예 |
|---|---|---|
in production / in staging | 환경을 말할 때 | It only fails in the staging environment. |
on a branch / on main | 어느 브랜치에 있는지 말할 때 | I'm on the release branch. |
in a file / on line 42 | 코드 위치를 짚을 때 | Check the null check in utils.ts, on line 42. |
in the repo / on GitHub | 저장소 안 / 서비스 위 | The script is in the repo. The issue is on GitHub. |
comment on a PR / in the PR description | 코멘트를 남기는 대상 / 글이 담긴 곳 | I commented on your PR. / See the steps in the PR description. |
merge into | 다른 브랜치로 합칠 때 | Merge it into main after the review. |
deploy to / push to | 어디로 보낼 때 | Deploy to production. / Push to origin. |
at / on / in (시간) | 시각 / 요일·날짜 / 하루 중 때 | at 3 p.m., on Monday, in the morning |
by / until | 마감 / 계속되는 끝 | Ship it by Friday. / Monitor it until Friday. |
in production, 줄과 면 위는 on main, on line 42, on GitHub입니다. 마감은 by Friday, 계속되는 끝은 until Friday입니다.in으로 옮기면 in main, in line 42처럼 됩니다. '-까지'를 늘 until로 옮기면 Review it until Friday가 되어 '금요일까지 계속 리뷰하라'는 뜻이 됩니다.함정 찾기: AI가 다듬어 준 장애 업데이트
결제 버그 진행 상황을 장애 채널에 올릴 영어 업데이트로 다듬어 줘.
- 원인 위치
- 수정 브랜치
- 배포 일정
의심스러운 줄을 모두 눌러 표시한 뒤 “검토 끝”을 누르세요. 함정은 3개입니다.
연습
1. 스테이징 환경의 로그를 봐 달라고 할 때:
"Can you check the logs ___ the staging environment?"
2. 지금 체크아웃해 둔 브랜치가 main이라고 말할 때: "I'm ___ main right now."
3. 릴리스가 월요일이라 금요일 전에는 리뷰를 끝내 달라고 할 때:
"Please review the PR ___ Friday."
4. 핫픽스를 main에 합친 뒤 운영에 배포하라고 할 때:
"Merge the hotfix ___ main and deploy it ___ production."