리뷰어가 PR에 코멘트를 여러 개 남겨 주었다. 다 반영하고 나서 "피드백 감사합니다"라고 답하려 한다. 코멘트가 여러 개였으니 영어로도 복수형(plural) feedbacks가 맞을 것 같고, 하나하나가 의견이니 a feedback도 될 것 같다.
| 용어 | 뜻 |
|---|---|
| 셀 수 있는 명사(countable noun) | 하나, 둘로 셀 수 있어서 숫자를 바로 붙일 수 있는 명사. 예: two comments |
| 셀 수 없는 명사(uncountable noun) | 셀 수 있는 명사와 달리 하나, 둘로 나눠 세지 않는 명사. 예: information |
| 단수 / 복수(singular / plural) | 하나를 말하는 형태 / 둘 이상을 말하는 형태. 복수는 대개 끝에 -s가 붙는다. 예: a comment / comments |
| 주어(subject) | 문장에서 동작이나 상태의 주인이 되는 말. 대개 동사 바로 앞에 온다. 예: The build is slow.의 The build |
| 명사구(noun phrase) | 명사 하나를 중심으로 앞뒤에 꾸미는 말이 붙어 한 덩어리가 된 말. 예: the retry limit |
리뷰어에게 남길 감사 인사로 알맞은 것은?
규칙: 복수형도 a도 붙지 않는다
A. 셀 수 없는 명사는 복수형으로 쓰지 않고 a/an도 붙이지 않는다(British Council: Uncount nouns). 숫자도 바로 붙이지 않는다. two information은 틀린다(Cambridge Dictionary: Nouns: countable and uncountable). 주어(subject)로 올 때 동사는 단수형(singular, is, was)으로 받는다. 셀 수 있는 명사(countable noun)에 쓰는 a/an은 Unit 7에 있다. 개발 글에 나오는 말 중 Oxford Learner's Dictionaries가 셀 수 없는 명사로 싣는 것들이다.
feedback,information,advice,documentationsoftware,hardware,equipment,researchcode(프로그램 코드라는 뜻일 때)The documentation is out of date./This information is cached for an hour.
B. 양은 some, any, a lot of, much, a piece of로 말한다. 같은 British Council 문서가 셀 때 a piece of, a bit of를 쓴다고 설명한다.
I have some feedback on the API design.Is there any documentation for this endpoint?That's a lot of code for a date picker.a useful piece of advice
C. 세고 싶으면 셀 수 있는 말로 바꾼다. Cambridge의 같은 문서도 셀 수 없는 명사가 가리키는 것 하나하나를 말할 때 셀 수 있는 명사구(noun phrase)로 바꿔 쓴다고 설명한다. 리뷰에서는 a piece of feedback보다 무엇을 세는지 드러나는 말이 더 분명하다. a code change, a code snippet처럼 code가 앞에서 꾸밀 때는 뒤의 명사(change, snippet)를 세는 것이라 a도 -s도 붙는다.
feedback→a comment,two suggestionscode→a code change,a snippet,a few lines of codesoftware→a tool,two apps,a library
D. 뜻이 바뀌면 셀 수 있게 되기도 한다. code는 프로그램 코드라는 뜻일 때는 셀 수 없지만, 무언가를 나타내는 기호 체계라는 뜻일 때는 셀 수 있다. 같은 사전이 an error code will appear를 예문으로 싣는다(Oxford: code). HTTP 응답의 상태 코드도 이 뜻이라, HTTP 명세도 status codes라고 복수로 쓴다(RFC 9110: Status Codes). 그래서 error codes, status codes는 맞고 unused codes(쓰지 않는 코드)는 틀린다.
data는 사전마다, 분야마다 갈린다. Oxford는 셀 수 없는 명사와 복수 명사 둘 다로 싣고, 전문 분야 예문으로 These data show …를 든다(Oxford: data). Google 개발자 문서 스타일 가이드는 단수 취급하라고 한다(the data is, less data, word list: data). 개발 문서라면 the data is로 써도 된다. 논문 투의 글이나 팀 문서가 복수로 쓰면 그쪽을 따른다.
표현: 세는 말로 바꿔 쓰기
| 표현 | 언제 | 예 |
|---|---|---|
some feedback | 의견이 있다고 운을 뗄 때 | I have some feedback on the error messages. |
a comment / two comments | 리뷰 코멘트 개수를 말할 때 | I left two comments on the migration. |
a suggestion | 제안 하나를 꺼낼 때 | One suggestion: move this check into the hook. |
more information | 정보가 더 필요할 때 | Could you share more information about the setup? |
a code change / a few lines of code | 코드 양을 말할 때 | This only needs a few lines of code. |
error codes / status codes | 기호로서의 코드를 셀 때 | The API returns two error codes for this case. |
리뷰를 고맙다고 할 때는 feedback으로 뭉뚱그리고, 반영했다고 보고할 때는 I've addressed your comments.처럼 셀 수 있는 말로 쓰면 자연스럽다. 리뷰를 주고받는 방식은 코드 리뷰 노트에 있다.
feedback, information, code는 셀 수 없는 명사라 -s도 a도 붙지 않습니다. 세려면 three comments처럼 셀 수 있는 말로 바꿉니다.a lot of, some을 씁니다.feedbacks, codes가 됩니다. 영어에서 셀 수 없는 명사인지 사전의 uncountable 표시로 확인합니다.함정 찾기: AI가 다듬어 준 리뷰 답장
리뷰 코멘트 반영했다는 영어 답장을 써 줘.
- 피드백 고맙다는 인사
- 재시도 횟수 정보는 문서에서 못 찾음
- 안 쓰는 코드도 지움
의심스러운 줄을 모두 눌러 표시한 뒤 “검토 끝”을 누르세요. 함정은 3개입니다.
연습
1. 리뷰 코멘트 세 개를 남겼다고 개수까지 말할 때:
"I left three ___ on your PR."
2. 이 설정 옵션의 문서가 있는지 물을 때:
"Is there any ___ for this config option?"
3. 프로그램 코드라는 뜻으로, 이 PR이 코드를 많이 지운다고 할 때:
"This PR removes a lot of ___."
4. API가 돌려주는 HTTP 상태 코드 여러 개를 말할 때:
"The endpoint can return three ___."