Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

용어: Dependencies #841

Closed
1 task
gnujoow opened this issue Jan 6, 2024 · 6 comments
Closed
1 task

용어: Dependencies #841

gnujoow opened this issue Jan 6, 2024 · 6 comments
Labels
discussion Discuss the problem term 문서에서 사용하는 용어에 대한 논의

Comments

@gnujoow
Copy link
Member

gnujoow commented Jan 6, 2024

논의하고자 하는 용어

Dependencies

useEffect, useMemo, useCallback등 dependencies를 정의에 대한 표현이 다른것을 확인했습니다. 문서간의 통일성을 맞추고자 하나의 표현으로 통일을 제안합니다.

해당 용어가 등장하는 원문의 문장

종속성으로 표기하는 경우

https://ko.react.dev/learn/lifecycle-of-reactive-effects

effect에서 두 개의 변수(`serverUrl``roomId`)를 읽지만 종속성으로 `roomId`만 지정했습니다.

의존성으로 표기하는 경우

return () => connection.disconnect();
}, [roomId, serverUrl, onReceiveMessage]); // ✅ 모든 의존성이 정의됨.
}
```

원문 그대로 표기하는 경우

아래의 경우 useMemo의 매개변수를 설명하기 위해서 원문 그대로를 사용한듯 보입니다.
https://github.com/reactjs/ko.react.dev/blob/b6673d5290cf7e48297e8e6369458a9d7105992c/src/content/reference/react/useMemo.md?plain=1#L40C1-L43


논의가 완료된 후에 아래 내용을 업데이트 해주세요

@gnujoow gnujoow added discussion Discuss the problem term 문서에서 사용하는 용어에 대한 논의 labels Jan 6, 2024
@gnujoow
Copy link
Member Author

gnujoow commented Jan 6, 2024

종속되다 1 從屬되다

  1. 동사 자주성이 없이 주가 되는 것에 딸려 붙게 되다.
  2. 동사 문장의 구성 성분으로서 다른 부분에 대하여 주술, 수식, 조건적 접속 따위의 관계로 결합하게 되다.
    명사
  3. 자주성이 없이 주가 되는 것에 딸려 붙음.
    정치적 종속.
  4. 언어 문장의 구성 성분으로서 다른 부분에 대하여 주술, 수식, 조건적 접속 따위의 관계로 결합하는 일. 또는 그런 방식

의존하다 依存하다 어휘등급
동사 다른 것에 의지하여 존재하다.
명사 다른 것에 의지하여 존재함.

@gnujoow
Copy link
Member Author

gnujoow commented Jan 6, 2024

제안)
dependencies는 우리말로 의존, 종속으로 번역될수 있습니다. 하지만 이 문서에서는 의존성, 의존성 배열등으로 통일하는 것을 제안합니다.

  • "종속"은 한 요소가 다른 요소에 완전히 종속되어 자율성이 거의 없는 상태를 의미하는 경우가 많습니다. 반면, "의존"은 한 요소가 다른 요소를 필요로 하지만, 그것이 전체 구조나 시스템에 어떤 영향을 미치는지에 대한 더 폭넓은 의미를 담고 있습니다. 따라서 필요성 혹은 기능간의 연결을 뜻을 포함하는 "의존성"표현이 dependencies를 더 잘 표현한다고 생각합니다.
  • 일반적으로 소프트웨어에서 dependency는 의존성으로 번역되는 경우가 많습니다.

@gnujoow
Copy link
Member Author

gnujoow commented Jan 6, 2024

예외 추가)

### `useMemo(calculateValue, dependencies)` {/*usememo*/}

위 처럼 함수의 매개변수를 설명할때는 원문으로 적되 아래 설명에서는 원문과 번역을 병기한다.

* `dependencies`: `calculateValue` 코드 내에서 참조된 모든 반응형 값들의 목록입니다. 반응형 값에는 props, state와 컴포넌트 바디에 직접 선언된 모든 변수와 함수가 포함됩니다. 만약 linter가 [React용으로 설정된 경우](/learn/editor-setup#linting) 모든 반응형 값이 의존성으로 올바르게 설정되었는지 확인할 수 있습니다. 의존성 목록은 일정한 수의 항목을 가져야 하며, `[dep1, dep2, dep3]`와 같이 인라인 형태로 작성돼야 합니다. React는 [`Object.is`](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Global_Objects/Object/is) 비교를 통해 각 의존성 들을 이전 값과 비교합니다.

 * `dependencies (의존성)`: `calculateValue` 코드

@timingsniper
Copy link
Contributor

Depend라는 동사가 '의존하다'라는 뜻을 가지지만 '종속하다'라는 뜻은 가지고 있지 않기도 하고, @gnujoow 님의 말씀대로 일반적으로 소프트웨어에서 dependency는 의존성으로 번역되는 경우가 많기에 의존성으로의 통일을 제안합니다.

@taggon
Copy link
Collaborator

taggon commented Mar 28, 2024

패키지 동작을 생각해보면 "의존성"이 맞는 번역입니다.

@taggon
Copy link
Collaborator

taggon commented May 4, 2024

논의가 정리된 것으로 보여서 용어집에 'dependency'를 '의존성'으로 번역한다고 추가했습니다. 따라서 현재 논의는 닫겠습니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
discussion Discuss the problem term 문서에서 사용하는 용어에 대한 논의
Projects
None yet
Development

No branches or pull requests

3 participants