その命名にした意図は何でしょうか
코드 리뷰 미팅 — 지적하는 쪽과 받는 쪽이 서로 상하지 않게 말하는 법
일본어 · N2 · 대화 · 3:57
이 회차를 마치면: 코드 리뷰에서 근거를 들어 지적하고, 의도를 설명한 뒤 받아들일 수 있다
꼭 외울 표현
分けた方が読みやすいです
나누는 편이 읽기 쉽습니다
명령이 아니라 비교로 말해 지적을 부드럽게 할 때 씁니다. 「〜した方が」 뒤에 이유가 되는 형용사를 붙입니다.
する意図は何でしょうか
하는 의도는 무엇일까요
틀렸다고 단정하지 않고 먼저 상대의 의도를 묻는 표현입니다. 「なぜですか」 보다 공격적으로 들리지 않습니다.
ご指摘を踏まえて修正します
지적을 반영해서 수정하겠습니다
지적을 받아들였음을 알리고 다음 행동까지 함께 말할 때 씁니다. 리뷰를 닫는 격식 있는 한마디입니다.
대본과 번역
- N
안녕하세요. 지난 시간에는 장애 보고를 원인과 조치의 순서로 정리해 봤지요.
안녕하세요. 지난 시간에는 장애 보고를 원인과 조치의 순서로 정리해 봤지요.
- A
こんにちは。今日はコードレビューの場面をのぞいてみます。
안녕하세요. 오늘은 코드 리뷰 장면을 들여다보겠습니다.
- N
오늘 목표는 코드 리뷰에서 근거를 들어 지적하고, 의도를 설명한 뒤 받아들이는 것입니다.
오늘 목표는 코드 리뷰에서 근거를 들어 지적하고, 의도를 설명한 뒤 받아들이는 것입니다.
- B
おはようございます。今日はレビューをお願いします。
안녕하세요. 오늘은 리뷰를 부탁드립니다.
- A
はい。全体はよく動いています。まず一点、気になったところがあります。
네. 전체적으로는 잘 돌아갑니다. 우선 한 가지 마음에 걸린 곳이 있습니다.
- B
どこでしょうか。
어디일까요?
- A
この関数が長いですね。三つの処理に分けた方が読みやすいです。
이 함수가 기네요. 세 개의 처리로 나누는 편이 읽기 쉽습니다.
- B
たしかに。可読性のことは、あまり考えていませんでした。
확실히 그렇네요. 가독성은 별로 생각하지 않았습니다.
- A
もう一点。同じ値を二回確認していますが、二回確認する意図は何でしょうか。
한 가지 더요. 같은 값을 두 번 확인하는데, 두 번 확인하는 의도는 무엇일까요?
- B
昔の不具合の名残です。今はもう必要ありません。
예전 결함의 흔적입니다. 지금은 이미 필요 없습니다.
- A
では消しましょう。理由が残っていない処理は、あとの人を迷わせます。
그럼 지웁시다. 이유가 남아 있지 않은 처리는 나중 사람을 헤매게 합니다.
- B
読みやすさの話ですね。大学のとき、先生が私に本をあげました。
읽기 쉬움에 대한 이야기네요. 대학 때 선생님이 저에게 책을 주었습니다.
- A
いい話ですね。私も卒業のとき、先生が私に本をくれました。
좋은 이야기네요. 저도 졸업할 때 선생님이 저에게 책을 주셨습니다.
- B
そうなんです。先生が私に本をくれました。その本にも命名の章がありました。
그렇습니다. 선생님이 저에게 책을 주셨습니다. 그 책에도 명명에 관한 장이 있었습니다.
- A
ちょうどよかったです。この変数の命名も、少し短すぎると思います。
마침 잘됐네요. 이 변수의 명명도 조금 너무 짧다고 생각합니다.
- B
ご指摘を踏まえて修正します。名前を役割に合わせます。
지적을 반영해서 수정하겠습니다. 이름을 역할에 맞추겠습니다.
- A
ありがとうございます。最後に、ここで再試行する意図は何でしょうか。
감사합니다. 마지막으로 여기서 재시도하는 의도는 무엇일까요?
- B
通信が切れたときのためです。ただ、テストを書いていませんでした。
통신이 끊겼을 때를 위해서입니다. 다만 테스트를 쓰지 않았습니다.
- A
では、そこにテストを一つ足しておきましょう。意図が形として残ります。
그럼 거기에 테스트를 하나 추가해 둡시다. 의도가 형태로 남습니다.
- B
はい。長い条件文も、二つに分けた方が読みやすいですね。
네. 긴 조건문도 두 개로 나누는 편이 읽기 쉽겠네요.
- A
そのとおりです。指摘は人ではなく、コードに向けます。
그렇습니다. 지적은 사람이 아니라 코드를 향합니다.
- N
지적을 받을 때는 먼저 의도를 설명하고, 그다음에 무엇을 어떻게 고칠지 말하면 대화가 빨라집니다.
지적을 받을 때는 먼저 의도를 설명하고, 그다음에 무엇을 어떻게 고칠지 말하면 대화가 빨라집니다.
- A
分けた方が読みやすいです。
나누는 편이 읽기 쉽습니다.
- B
この設定ファイルも、環境ごとに分けた方が読みやすいです。
이 설정 파일도 환경별로 나누는 편이 읽기 쉽습니다.
- A
する意図は何でしょうか。
하는 의도는 무엇일까요?
- B
ここでログを二重に出力する意図は何でしょうか。
여기서 로그를 이중으로 출력하는 의도는 무엇일까요?
- A
ご指摘を踏まえて修正します。
지적을 반영해서 수정하겠습니다.
- B
今日いただいたご指摘を踏まえて修正します。
오늘 받은 지적을 반영해서 수정하겠습니다.
- N
세 덩이 모두 사람을 평가하지 않습니다. 비교, 질문, 다음 행동만 남기면 리뷰가 짧아집니다.
세 덩이 모두 사람을 평가하지 않습니다. 비교, 질문, 다음 행동만 남기면 리뷰가 짧아집니다.
- N
이제 여러분 차례입니다. 리뷰어가 되었다가 작성자가 되어 소리 내어 말해 보세요.
이제 여러분 차례입니다. 리뷰어가 되었다가 작성자가 되어 소리 내어 말해 보세요.
- A
この百行の関数、どう直せばいいと思いますか。
이 백 줄짜리 함수, 어떻게 고치면 좋다고 생각하세요?
- B
処理ごとに分けた方が読みやすいです。
처리별로 나누는 편이 읽기 쉽습니다.
- A
私の指摘、受け入れてもらえますか。
제 지적, 받아들여 주실 수 있나요?
- B
はい、ご指摘を踏まえて修正します。
네, 지적을 반영해서 수정하겠습니다.
- N
오늘은 근거를 들어 지적하고, 의도를 묻고, 받아들이는 세 걸음을 익혔습니다.
오늘은 근거를 들어 지적하고, 의도를 묻고, 받아들이는 세 걸음을 익혔습니다.
- A
三つの処理に分けた方が読みやすいです。
세 개의 처리로 나누는 편이 읽기 쉽습니다.
- B
ここで再試行する意図は何でしょうか。
여기서 재시도하는 의도는 무엇일까요?
- A
ご指摘を踏まえて修正します。
지적을 반영해서 수정하겠습니다.
- B
では、次のレビューでまたお願いします。
그럼 다음 리뷰에서 또 부탁드립니다.
이 회차의 낱말
| 표현 | 읽기 | 뜻 |
|---|---|---|
| レビュー | れびゅー | 리뷰 |
| 指摘 | してき | 지적 |
| 可読性 | かどくせい | 가독성 |
| 意図 | いと | 의도 |
| 修正 | しゅうせい | 수정 |
| 命名 | めいめい | 명명, 이름 짓기 |
| テスト | てすと | 테스트 |