Skip to content

1st commit: Issue #110(Intro to JS with TS) 번역 #146

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

Merged
merged 4 commits into from
Sep 1, 2020

Conversation

dhyoo99
Copy link
Contributor

@dhyoo99 dhyoo99 commented Aug 17, 2020

Issue #110(Intro to JS with TS) 번역했습니다!

번역하면서 몇 가지 애매했던 부분들 질문 및 메모 남깁니다.

  1. line10에 'A type-system based only on inference with JavaScript code.'의 inference를 '추론'이라고 번역하는 게 어색하다고 느껴집니다. 그런데 자연스러운 번역이 떠오르지 않아 직독직해를 하였는데, 더 좋은 해석이 있다면 조언 부탁드립니다 :) '타입시스템은 오직 JavaScript 코드만을 참조한다.'라는 번역도 생각해보았는데 어떻게 생각하시나요?

  2. line11에 'Incremental typing'을 어떻게 해석해야할지 몰라 원문 그대로 남겼습니다. 좋은 번역, 또는 해당 문구와 관련하여 실무에서 많이 쓰는 용어가 있을까요?

  3. line26에서 declaration를 '선언'이라고 번역하였는데 괜찮을까요?

  4. ok를 성공, error를 오류로 번역하라고 하셨는데, 'not ok'라고 쓰여 있어 오류가 아닌 '성공 아님'으로만 일단 번역하였습니다.

마지막으로 수정/보완했으면 하는 부분 메모 남겨주시면 참고하여 수정본 올리도록 하겠습니다. 감사합니다!! :-)

@dvlprsh dvlprsh requested review from bumkeyy, dvlprsh and guyeol August 17, 2020 23:13

Each step represents a move towards a safer type-system, but not every project needs that level of verification.
각 단계는 더 안전한 타입시스템을 위한 움직임에 해당하지만, 반드시 모든 프로젝트가 해당 수준에 맞는 검증을 필요로 하는 것은 아닙니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
각 단계는 더 안전한 타입시스템을 위한 움직임에 해당하지만, 반드시 모든 프로젝트가 해당 수준에 맞는 검증을 필요로 하는 것은 아닙니다.
각 단계는 타입 시스템을 더 안전하게 만들지만, 반드시 모든 프로젝트가 수준에 맞는 검증을 필요로 하는 것은 아닙니다.


## TypeScript with JavaScript
## JavaScript를 활용한 TypeScript(TypeScript with JavaScript)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## JavaScript를 활용한 TypeScript(TypeScript with JavaScript)
## JavaScript를 활용한 TypeScript (TypeScript with JavaScript)


This is when you use an editor which uses TypeScript to provide tooling like auto-complete, jump to symbol and refactoring tools like rename.
The [homepage](/) has a list of editors which have TypeScript plugins.
이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩터링(refactoring) 도구와 같은 툴을 제공하기 위하여 TypeScript를 사용하는 편집기를 사용하는 경우에 유용합니다. [홈페이지](/)에는 TypeScript 플러그인들이 있는 편집자 목록이 있습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩터링(refactoring) 도구와 같은 툴을 제공하기 위하여 TypeScript를 사용하는 편집기를 사용하는 경우에 유용합니다. [홈페이지](/)에는 TypeScript 플러그인들이 있는 편집자 목록이 있습니다.
자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩토링 툴을 제공하기 위해서 TypeScript를 사용하는 에디터를 사용할 때 유용합니다.
[홈페이지](/)에는 TypeScript 플러그인들이 있는 에디터 목록이 있습니다.

라인수는 맞춰주세요 :)


## Providing Type Hints in JS via JSDoc
## JSDoc을 통하여 JS에 타입 힌트 제공(Providing Type Hints in JS via JSDoc)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## JSDoc을 통하여 JS에 타입 힌트 제공(Providing Type Hints in JS via JSDoc)
## JSDoc을 통하여 JS에 타입 힌트 제공하기 (Providing Type Hints in JS via JSDoc)


JSDoc annotations come before a declaration will be used to set the type of that declaration. For example:
JSDoc 표기들은 선언 전에 와서 특정 선언들의 타입을 설정하는 데 사용됩니다. 예를 들어,

```js twoslash
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```js twoslash
```js

twoslash는 현재 파싱하지 못해서 오류가 발생합니다.
번역 후 제대로 반영됬는지 로컬에서 빌드하는 걸 추천드립니다 :)

twoslash는 제거해주세요 😄


In a `.js` file, types can often be inferred. When types can't be inferred, they can be specified using JSDoc syntax.
`.js` 파일에서는, 종종 타입들을 유추할 수 있습니다. 타입들을 유추할 수 없는 경우, JSDoc 구문을 사용하여 구체적으로 밝힐 수 있습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`.js` 파일에서는, 종종 타입들을 유추할 수 있습니다. 타입들을 유추할 수 없는 경우, JSDoc 구문을 사용하여 구체적으로 밝힐 수 있습니다.
`.js` 파일에서는, 종종 타입들을 유추할 수 있습니다. 타입들을 유추할 수 없는 경우, JSDoc 구문을 사용하여 구체적으로 알릴 수 있습니다.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[제안]

```

You can find the full list of supported JSDoc patterns [in JSDoc Supported Types](/docs/handbook/jsdoc-supported-types.html).
지원되는 JSDoc 패턴의 전체 목록은 [JSDoc가 지원되는 유형에서](/docs/handbook/jsdoc-supported-types.html) 찾을 수 있습니다.
Copy link
Member

@bumkeyy bumkeyy Aug 18, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
지원되는 JSDoc 패턴의 전체 목록은 [JSDoc가 지원되는 유형에서](/docs/handbook/jsdoc-supported-types.html) 찾을 수 있습니다.
지원되는 JSDoc 패턴의 전체 목록은 [JSDoc가 지원하는 타입에서](/docs/handbook/jsdoc-supported-types.html) 찾을 수 있습니다.


TypeScript may offer you errors which you disagree with, in those cases you can ignore errors on specific lines by adding `// @ts-ignore` or `// @ts-expect-error` on the preceding line.
TypeScript는 당신이 동의하지 않는 오류들을 제공할 수도 있는데, 이 경우 특정 줄 맨앞에 `// @ts-ignore` 또는 `// @ts-expect-error`를 추가하여 그 줄의 오류를 무시할 수 있습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
TypeScript는 당신이 동의하지 않는 오류들을 제공할 수도 있는데, 이 경우 특정 줄 맨앞에 `// @ts-ignore` 또는 `// @ts-expect-error`를 추가하여 그 줄의 오류를 무시할 수 있습니다.
TypeScript는 우리가 동의하지 않는 오류들을 제공할 수도 있는데, 이 경우 특정 줄 맨앞에 `// @ts-ignore` 또는 `// @ts-expect-error`를 추가하여 그 줄의 오류를 무시할 수 있습니다.

[제안]
당신보다는 우리가 어떨까요?

// @ts-expect-error
x = false; // Not OK
x = 0; // 성공
// @ts는-오류라고-판단할 코드
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// @ts는-오류라고-판단할 코드
// @ts-expect-error

해당 라인은 문법이므로 유지해주세요 :)

JavaScript를 TypeScript로 해석하는 방법에 대한 자세한 내용은 [TS Type이 JS를 체크하는 방법](/docs/handbook/type-checking-javascript-files.html)을 참고하시기 바랍니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
JavaScript를 TypeScript로 해석하는 방법에 대한 자세한 내용은 [TS Type이 JS를 체크하는 방법](/docs/handbook/type-checking-javascript-files.html)을 참고하시기 바랍니다.
JavaScript를 TypeScript로 해석하는 방법에 대한 자세한 내용은 [TS 타입이 JS를 체크하는 방법](/docs/handbook/type-checking-javascript-files.html)을 참고하시기 바랍니다.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dhyoo99
수정하시면서 이 부분 누락되었네요!! 확인부탁드려요 :)

@bumkeyy
Copy link
Member

bumkeyy commented Aug 18, 2020

Issue #110(Intro to JS with TS) 번역했습니다!

번역하면서 몇 가지 애매했던 부분들 질문 및 메모 남깁니다.

  1. line10에 'A type-system based only on inference with JavaScript code.'의 inference를 '추론'이라고 번역하는 게 어색하다고 느껴집니다. 그런데 자연스러운 번역이 떠오르지 않아 직독직해를 하였는데, 더 좋은 해석이 있다면 조언 부탁드립니다 :) '타입시스템은 오직 JavaScript 코드만을 참조한다.'라는 번역도 생각해보았는데 어떻게 생각하시나요?
  2. line11에 'Incremental typing'을 어떻게 해석해야할지 몰라 원문 그대로 남겼습니다. 좋은 번역, 또는 해당 문구와 관련하여 실무에서 많이 쓰는 용어가 있을까요?
  3. line26에서 declaration를 '선언'이라고 번역하였는데 괜찮을까요?
  4. ok를 성공, error를 오류로 번역하라고 하셨는데, 'not ok'라고 쓰여 있어 오류가 아닌 '성공 아님'으로만 일단 번역하였습니다.

마지막으로 수정/보완했으면 하는 부분 메모 남겨주시면 참고하여 수정본 올리도록 하겠습니다. 감사합니다!! :-)

  1. 추론 괜찮은 것 같아요 ㅎㅎㅎ
  2. 점차적인 타이핑? 전 원문이 더 나은 것 같네요 :)
  3. 괜찮습니다.
  4. LGTM 😄

원문과 라인 수 는 맞춰주세요.

수고하셨습니다 👍


JSDoc annotations come before a declaration will be used to set the type of that declaration. For example:
JSDoc 표기들은 선언 전에 와서 특정 선언들의 타입을 설정하는 데 사용됩니다. 예를 들어,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[제안]

Suggested change
JSDoc 표기들은 선언 전에 와서 특정 선언들의 타입을 설정하는 데 사용됩니다. 예를 들어,
JSDoc 주석은 선언 앞에 위치하며 특정 선언의 타입을 설정하는 데 사용됩니다. 예를 들어:


이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩터링(refactoring) 도구와 같은 툴을 제공하기 위하여 TypeScript를 사용하는 편집기를 사용하는 경우에 유용합니다. [홈페이지](/)에는 TypeScript 플러그인들이 있는 편집자 목록이 있습니다.
이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩토링 툴을 제공하기 위해서 TypeScript를 사용하는 에디터를 사용할 때 유용합니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩토링 툴을 제공하기 위해서 TypeScript를 사용하는 에디터를 사용할 때 유용합니다.
이는 자동 완성, 심벌로 이동 및 이름 바꾸기와 같은 리팩토링 툴을 제공하기 위해서 TypeScript를 사용하는 에디터를 사용할 때 유용합니다.

라인 끝 공백 때문에 린트 에러가 발생하네요 :)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

번역 후에 린트 테스트를 수행해주세요 :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

수행했습니다!

Copy link
Member

@dvlprsh dvlprsh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

twoslash 모두 지워주세요 :)

@guyeol
Copy link
Member

guyeol commented Aug 22, 2020

  1. line10에 'A type-system based only on inference with JavaScript code.'의 inference를 '추론'이라고 번역하는 게 어색하다고 느껴집니다. 그런데 자연스러운 번역이 떠오르지 않아 직독직해를 하였는데, 더 좋은 해석이 있다면 조언 부탁드립니다 :) '타입시스템은 오직 JavaScript 코드만을 참조한다.'라는 번역도 생각해보았는데 어떻게 생각하시나요?
  2. line11에 'Incremental typing'을 어떻게 해석해야할지 몰라 원문 그대로 남겼습니다. 좋은 번역, 또는 해당 문구와 관련하여 실무에서 많이 쓰는 용어가 있을까요?
  3. line26에서 declaration를 '선언'이라고 번역하였는데 괜찮을까요?
  4. ok를 성공, error를 오류로 번역하라고 하셨는데, 'not ok'라고 쓰여 있어 오류가 아닌 '성공 아님'으로만 일단 번역하였습니다.
  1. 추론 좋은 것 같네요
  2. JSDoc을 이용해 JavaScript에서 점진적으로 타입 적용하기 는 어떤가요?
  3. 괜찮습니다
  4. 오류라고 해도 괜찮을 것 같네요

guyeol and others added 2 commits September 1, 2020 10:29
Co-authored-by: Seohee Park <dvlprsh103@gmail.com>
Co-authored-by: Seohee Park <dvlprsh103@gmail.com>
@guyeol guyeol merged commit c43cc3b into typescript-kr:master Sep 1, 2020
@dvlprsh
Copy link
Member

dvlprsh commented Sep 1, 2020

@all-contributors please add @dhyoo99 for translation

@allcontributors
Copy link
Contributor

@dvlprsh

I've put up a pull request to add @dhyoo99! 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants