오늘의 영어 표현 29/30 · 단계: 머지 뒤. 예문은 모두 이 글을 위해 지어낸 것입니다. 실제 저장소의 댓글을 옮긴 것이 아니며, 버전과 번호는 예시입니다.
목차
한눈에 보기
| 표현 | This landed in main. / The fix will ship in v1.5.0. |
| 뜻 | main 에 병합되었습니다 / 이 수정은 v1.5.0 에 실려 나갑니다. |
| 쓰는 자리 | 이슈 마무리 댓글, 릴리스 안내, Slack |
| 공손함 | 중립. 상태를 알리는 말입니다 |
1. 뜻과 뉘앙스
land 는 「착륙하다」입니다. 개발 현장에서는 여기서 나와 「변경이 리뷰를 통과해 저장소의 주 브랜치에 들어가다」라는 뜻으로 씁니다. Chromium 의 기여 문서도 커밋 메시지가 변경이 「Chromium 트리에 landed 될 때」 쓰인다고 하고, 부모 변경이 「main 에 lands 하기 전」이라는 말을 씁니다. 자동사로 This landed, 타동사로 I landed the change 둘 다 씁니다.
머지 뒤에 가장 자주 받는 질문은 「그래서 언제 쓸 수 있나요?」입니다. 이때 병합과 릴리스를 구분해서 말해야 합니다.
- landed / merged: main 브랜치에 들어갔다. 아직 릴리스는 안 됐을 수 있습니다.
- released / shipped: 릴리스에 실려 사용자가 받을 수 있다.
- will be in / will ship in (버전): 다음 릴리스에 포함될 예정이다.
이것을 섞어 쓰면 오해가 생깁니다. 사용자가 「고쳐졌다」는 말만 듣고 현재 버전으로 올렸는데 여전히 버그가 있으면, 이슈가 다시 열리고 불필요한 대화가 이어집니다. 그래서 이슈를 닫을 때는 어느 브랜치에 들어갔고, 어느 버전에 나갈지를 함께 적는 것이 좋습니다. 릴리스 브랜치로 따로 옮겨야 하는지는 30편의 backport 에서 다룹니다.
2. 예문
상황 1: 이슈를 닫으며
The fix landed in main via #4210 and will be included in v1.5.0. Closing this, but feel free to reopen if you still see the problem after upgrading.
via 는 「~을 통해」입니다. feel free to reopen 은 다시 열어도 된다는 허락으로, 닫는 말을 부드럽게 만듭니다.
상황 2: 사용자의 질문에 답할 때
It's merged but not released yet. If you need it now, you can try the nightly build; otherwise it'll ship in the next minor release.
nightly build 는 매일 밤 main 에서 만드는 시험용 빌드입니다. 프로젝트에 따라 이름이 다릅니다.
상황 3: Slack 에서 기쁜 소식을 알릴 때
My first PR to the project just landed! Thanks to everyone who reviewed it.
3. 비슷한 표현과 차이
- Merged. 가장 직접적이고 오해가 없습니다. GitHub 화면의 상태 이름과 같습니다.
- Shipped in v1.5.0. 이미 릴리스에 실려 나갔다는 뜻입니다. 사용자는 그 버전부터 쓸 수 있습니다.
- Available in v1.5.0 and later. 「v1.5.0 이상에서 쓸 수 있다」로, 문서나 릴리스 노트에서 쓰는 정확한 표현입니다.
4. 한국인이 자주 하는 실수
- It is reflected. 「반영되었다」를 직역하면 무엇에 어떻게 반영됐는지 알 수 없습니다(17편의 reflect 와 같은 실수).
- 고친 문장: The fix has been merged into main.
- It is fixed. Please update. 아직 릴리스가 안 됐다면 사용자는 올릴 버전이 없습니다.
- 고친 문장: It's fixed in main and will be in v1.5.0.
- This was merged in v1.5.0. 병합은 브랜치에서 일어나고, 버전은 릴리스의 이름입니다. 버전과 함께 쓸 때는 included 나 shipped 가 정확합니다.
- 고친 문장: This is included in v1.5.0. 또는 This shipped in v1.5.0.
5. 한 줄 연습
다음 한국어 문장을 이슈를 닫는 댓글로 바꿔 쓰십시오.
이 수정은 main 에 병합되었고 다음 패치 릴리스에 포함됩니다. 그때 다시 확인해 주세요.
모범 답안
This fix landed in main and will be part of the next patch release. Please give it a try once it's out.
be part of 는 「~에 포함되다」를 자연스럽게 옮긴 말입니다. once it's out 은 「나오면」으로, 릴리스 시점을 정확히 모를 때 쓰기 좋습니다.
티티 한마디. 「들어갔다」와 「나갔다」는 다릅니다. 둘을 나눠 말하면 같은 질문을 두 번 받지 않습니다.
참고
- Chromium, Contributing to Chromium(Committing): https://chromium.googlesource.com/chromium/src/+/main/docs/contributing.md
- Merriam-Webster, 「ship」: https://www.merriam-webster.com/dictionary/ship