Conversation
There was a problem hiding this comment.
Code Review
이번 풀 리퀘스트는 express-cargo 라이브러리에서 누락된 필드를 처리하는 @Default 및 @Optional 데코레이터에 대한 신규 문서(missing-fields.md)를 추가하고, 다국어 번역본을 포함하여 기존 문서를 전반적으로 업데이트 및 재구성합니다. 제공된 코드 리뷰 피드백은 한국어 번역 문서(missing-fields.md)에서 직역되어 어색하거나 모호하게 표현된 문장들을 더 자연스럽고 명확한 한국어 표현으로 개선할 것을 제안하고 있습니다.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
|
|
||
| ## `@Optional()` | ||
|
|
||
| `@Optional` 데코레이터는 필드를 선택 사항으로 표시하여, "required" 오류를 발생시키지 않고 필드를 생략하거나 `undefined`/`null`로 설정할 수 있도록 합니다. 필드가 누락되면 `null`로 남고, 해당 필드의 검증 규칙은 건너뜁니다. |
There was a problem hiding this comment.
"필드가 누락되면 null로 남고"라는 표현보다는, 라이브러리의 동작 방식(바인딩)을 명확히 나타내기 위해 "null로 바인딩되고" 또는 "null로 설정되고"로 수정하는 것이 더 일관성 있고 자연스럽습니다. 아래의 예시 설명(64행)에서도 "바인딩되고"라는 표현을 사용하고 있으므로 일관성을 높일 수 있습니다.\n\n제안:\nmarkdown\n`@Optional` 데코레이터는 필드를 선택 사항으로 표시하여, "required" 오류를 발생시키지 않고 필드를 생략하거나 `undefined`/`null`로 설정할 수 있도록 합니다. 필드가 누락되면 `null`로 바인딩되고, 해당 필드의 검증 규칙은 건너뜁니다.\n
References
- 코드 리뷰는 명확하고 이해하기 쉬운 한국어 문장을 사용하여 피드백을 제공해야 하며, 문서는 항상 읽기 쉽고 이해하기 쉬워야 합니다. (link)
기존에 비어있던 문서를 채우고, 짧은 정보만 있던 문서를 보강합니다.
advanced/default.md->decorators/missing-fileds.md로 이관하고,default데코레이터와optional데코레이터 설명을 추가inherited-binding.md문서 내용 추가basic-usage.md문서 내용 추가overview.md문서 내용 추가