This is out of scope for this PR: 범위를 지키며 정중하게 선을 긋기

오늘의 영어 표현 9/30 · 단계: PR 설명. 예문은 모두 이 글을 위해 지어낸 것입니다. 실제 저장소의 PR 을 옮긴 것이 아니며, 기능 이름은 예시입니다.

목차

• 한눈에 보기
• 1. 뜻과 뉘앙스
• 2. 예문
• 3. 비슷한 표현과 차이
• 4. 한국인이 자주 하는 실수
• 5. 한 줄 연습
• 모범 답안
• 참고

한눈에 보기

1. 뜻과 뉘앙스

scope 는 일이나 논의가 다루는 「범위」입니다. in scope 는 범위 안, out of scope 는 범위 밖입니다. This is out of scope for this PR 은 「그 제안이 틀렸다」가 아니라 「이번 PR 이 다루기로 한 범위가 아니다」라는 뜻입니다. 그래서 상대의 제안을 부정하지 않고도 PR 을 작게 유지할 수 있습니다.

PR 을 작게 유지하는 것은 오픈소스에서 중요한 원칙입니다. 리뷰어가 한 번에 이해할 수 있는 양이 정해져 있고, 범위가 넓어질수록 병합이 늦어집니다. 다만 이 말만 단독으로 쓰면 다소 딱딱하게 들립니다. 대안을 함께 제시하는 것이 관례입니다. 「따로 이슈를 열겠다」, 「후속 PR 로 하겠다」처럼 그 일이 사라지지 않는다는 점을 보여 줍니다.

리뷰어도 이 표현을 씁니다. 기여자가 PR 에 관련 없는 변경을 섞었을 때 「이 부분은 범위 밖이니 빼 주세요」라고 말할 때입니다. 이때는 Could you drop this change? It's out of scope for this PR. 처럼 요청과 함께 씁니다.

2. 예문

상황 1: PR 설명에 범위를 미리 밝힐 때

Out of scope: This PR doesn't change the CLI output format. I'll open a separate issue for that.

PR 설명에 In scope / Out of scope 를 미리 적어 두면 리뷰에서 같은 질문이 반복되지 않습니다.

상황 2: 리뷰어의 제안에 답할 때

Good idea, but I think it's out of scope for this PR. I've opened #2345 to track it so we don't lose it.

so we don't lose it 은 「잊어버리지 않도록」이라는 뜻으로, 제안을 존중한다는 신호입니다.

상황 3: 리뷰어가 범위를 좁혀 달라고 할 때

The formatting changes in utils.go look unrelated. Could you move them to a separate PR? They're out of scope here and make the diff harder to review.

3. 비슷한 표현과 차이

• I'd rather keep this PR focused. 「이 PR 은 한 가지에 집중하고 싶다」로, 범위 밖이라는 말을 더 부드럽게 바꾼 표현입니다.
• Beyond the scope of this PR. 같은 뜻이고 조금 더 격식 있습니다. 문서나 설계 문서에서 자주 씁니다.
• Let's handle that separately. 범위를 말하지 않고 바로 해결책을 제시합니다. 짧고 협조적입니다.

4. 한국인이 자주 하는 실수

• It is not my job. 「그건 제 일이 아닙니다」로 들려 무례할 수 있습니다. 범위의 문제로 바꿔 말합니다.
  • 고친 문장: That's out of scope for this PR, but I'm happy to look at it in a follow-up.
• This is out of range of this PR. range 는 숫자나 값의 범위에 씁니다. 일의 범위는 scope 입니다.
  • 고친 문장: This is out of scope for this PR.
• I can't do it in this PR. 능력 문제처럼 들립니다. 의도적으로 나누는 것임을 밝힙니다.
  • 고친 문장: I'd prefer to do it in a separate PR to keep this one small.

5. 한 줄 연습

다음 한국어 문장을 리뷰 답글로 바꿔 쓰십시오.

좋은 지적인데, 이번 PR 범위 밖인 것 같습니다. 따로 이슈를 열어 두었습니다.

모범 답안

Good point, but I think this is out of scope for this PR. I've opened a separate issue to track it.

to track it 은 「추적하기 위해」, 곧 잊지 않고 관리하기 위해서라는 뜻입니다. 오픈소스에서 이슈를 여는 목적을 말할 때 자주 씁니다.

티티 한마디. 「안 한다」가 아니라 「여기서는 안 한다, 저기서 한다」라고 말하면 선을 그어도 관계는 그대로입니다.

참고

• Merriam-Webster, 「scope」: https://www.merriam-webster.com/dictionary/scope
• Google Engineering Practices, Small CLs: https://google.github.io/eng-practices/review/developer/small-cls.html