오늘의 영어 표현 10/30 · 단계: PR 설명. 예문은 모두 이 글을 위해 지어낸 것입니다. 실제 저장소의 PR 을 옮긴 것이 아니며, 번호는 예시입니다.
목차
한눈에 보기
| 표현 | I'll address this in a follow-up (PR). |
| 뜻 | 이 부분은 후속 PR 에서 처리하겠습니다. |
| 쓰는 자리 | 리뷰 답글, PR 설명의 남은 일 절 |
| 공손함 | 보통. 이유와 함께 쓰면 신뢰를 줍니다 |
1. 뜻과 뉘앙스
follow-up 은 「뒤따르는 일, 후속 조치」라는 뜻의 명사이자 형용사입니다. a follow-up PR 은 「후속 PR」, a follow-up issue 는 「후속 이슈」입니다. 짧게 in a follow-up 이라고만 써도 PR 을 뜻하는 것으로 알아듣습니다. address 는 여기서 「(문제를) 다루다, 처리하다」라는 뜻입니다.
이 표현은 「거절이 아니라 순서의 문제」라는 뜻을 담습니다. 9편의 out of scope 와 짝을 이룹니다. 범위 밖이라고 선을 긋고, 대신 언제 어디서 처리할지를 이 표현으로 약속합니다.
주의할 점이 있습니다. 리뷰어는 이 말을 경계하기도 합니다. Google 의 코드 리뷰 지침은 리뷰어가 「나중에 정리하겠다」는 약속을 받아들이기보다 대개 병합 전에 정리를 요구하라고 권합니다. 후속 정리가 실제로는 자주 이루어지지 않기 때문입니다. 그래서 이 말을 쓸 때는 믿을 근거를 함께 줍니다. 후속 이슈 번호를 걸어 두거나, 이번 PR 을 작게 유지해야 하는 이유를 적거나, 후속 PR 을 바로 열어 두는 것입니다. 리뷰어가 「이번 PR 에서 해 달라」고 다시 말하면, 대개 그 요청을 따르는 편이 빠릅니다.
동사로 쓸 때는 띄어 씁니다. 「후속 조치를 하다」는 follow up (on something) 입니다. I'll follow up on this next week 처럼 씁니다.
2. 예문
상황 1: 리뷰 답글
Agreed that the error messages could be clearer. I'd like to keep this PR small, so I'll address it in a follow-up. Opened #3101 to track it.
상황 2: PR 설명의 남은 일 절
Follow-ups:
- Add e2e coverage for the IPv6 path (#3102)
- Update the user guide once the API is finalized
남은 일을 PR 설명에 목록으로 적어 두면 리뷰어가 안심하고 승인할 수 있습니다.
상황 3: 후속 PR 을 열고 원래 PR 에 알릴 때
Follow-up PR is up: #3110. It addresses the remaining comments from this review.
is up 은 「올라와 있다」라는 구어입니다.
3. 비슷한 표현과 차이
- Let's do this as a separate PR. 후속인지 별도 작업인지를 가리지 않는 표현입니다. 앞뒤 순서가 중요하지 않을 때 씁니다.
- I'll follow up on this. 동사형입니다. PR 이 아니라 질문이나 조사를 나중에 이어서 하겠다는 뜻에도 씁니다.
- TODO(follow-up). 코드 주석에 남기는 표시입니다. 이슈 번호와 함께 남겨야 실제로 추적됩니다.
4. 한국인이 자주 하는 실수
- I will follow-up this in next PR. 동사에는 하이픈을 쓰지 않고, 관사 a 와 전치사 on 이 빠졌습니다.
- 고친 문장: I'll follow up on this in a separate PR.
- I will fix it next time. next time 이 언제인지 알 수 없어 약속으로 들리지 않습니다.
- 고친 문장: I'll address this in a follow-up PR. Tracking it in #3101.
- This will be done later. 수동태라 누가 할지 빠져 있습니다.
- 고친 문장: I'll take care of this in a follow-up.
5. 한 줄 연습
다음 한국어 문장을 리뷰 답글로 바꿔 쓰십시오.
테스트 추가는 후속 PR 에서 하겠습니다. 이번 PR 은 버그 수정만 담고 싶습니다.
모범 답안
I'll add the tests in a follow-up PR. I'd like to keep this one focused on the bug fix.
this one 은 this PR 을 반복하지 않기 위한 대명사입니다. keep ... focused on 은 「~에 집중하게 하다」라는 뜻입니다.
티티 한마디. 「나중에」라는 말은 번호가 붙어 있을 때만 믿음을 얻습니다.
참고
- Google Engineering Practices, Handling pushback in code reviews: https://google.github.io/eng-practices/review/reviewer/pushback.html
- Merriam-Webster, 「follow-up」: https://www.merriam-webster.com/dictionary/follow-up