Korean Localization Coordination Issue

[orta]

For this language there are 723 translated files, with 1242 TODO.

Playground

Done: 54, TODO: 35.

• sections.json
• Big number literals.ts
• Const to let.ts
• Infer From Usage Changes.ts
• Flattened Error Reporting.ts
• Optional Chaining.ts
• Assertion Functions.ts
• Uncalled Function Checks.ts
• Checking Unions with Index Signatures.ts
• Export Modules From.ts
• Private Class Fields.ts
• Type Imports.tsx
• Class Constructor Code Flow.ts
• JSDoc Deprecated.ts
• Logical Operators and Assignment.ts
• Unknown in Catch.ts
• TypeScript with Node.js
• TypeScript with React.tsx
• TypeScript with Web.js
• Function Chaining.ts
• Generic Functions.ts
• Typing Functions.ts
• Errors.ts
• Quick Fixes.ts
• Code Flow.ts
• Functions.ts
• Hello World.ts
• Objects and Arrays.ts
• Async Await.ts
• Immutability.ts
• Import Export.ts
• Classes 101.ts
• Generic Classes.ts
• Mixins.ts
• JavaScript Playgrounds.js
• Fixits.ts
• Mobile Support.ts
• TypeScript Versions.ts
• Structural Typing.ts
• Type Guards.ts
• Enums.ts
• Nominal Typing.ts
• Types vs Interfaces.ts
• Conditional Types.ts
• Discriminate Types.ts
• Indexed Types.ts
• Mapped Types.ts
• Any.ts
• Literals.ts
• Union and Intersection Types.ts
• Unknown and Never.ts
• Built-in Utility Types.ts
• Nullable Types.ts
• Tuples.ts
• Nullish Coalescing.ts
• Recursive Type References.ts
• Accessibility Modifiers.js
• Nullish Coalescing.ts
• Named Tuples.ts
• Variadic Tuples.ts
• New JSX Support.tsx
• See in JSDoc.ts
• Intro to Template Literals.ts
• Mapped Types with Template Literals.ts
• String Manipulation with Template Literals.ts
• Create Function from Call.ts
• Abstract Class Constructors.ts
• Rest Elements in Tuple Types.ts
• Smarter Type Alias Preservation.ts
• Use Index Accessors for Index Signatures.ts
• No Implicit Class Overrides.ts
• Separate Write vs Read on Properties.ts
• Control Flow Improvements.ts
• Errors for High Confidence Errors.ts
• Exact Optional Properties.ts
• Use unknown for Catch Variables.ts
• Control Flow Improvements.ts
• Improved Function Inference.ts
• Extends Constraints.ts
• Instantiation Expressions.ts
• TypeScript with Deno.ts
• TypeScript with WebGL.js
• JSDoc Support.js
• This.ts
• New Compiler Defaults.ts
• Automatic Type Acquisition.ts
• Sharable URLs.ts
• Soundness.ts
• Type Widening and Narrowing.ts

TSConfig Reference

Done: 36, TODO: 121.

• intro.md
• Additional_Checks_6176.md
• Advanced_Options_6178.md
• Basic_Options_6172.md
• Command_line_Options_6171.md
• Experimental_Options_6177.md
• Module_Resolution_Options_6174.md
• Project_Files_0.md
• Source_Map_Options_6175.md
• Strict_Type_Checking_Options_6173.md
• alwaysStrict.md
• baseUrl.md
• charset.md
• composite.md
• declaration.md
• exclude.md
• files.md
• include.md
• jsxFragmentFactory.md
• jsxImportSource.md
• lib.md
• listFiles.md
• locale.md
• moduleResolution.md
• newLine.md
• noImplicitAny.md
• noResolve.md
• out.md
• outDir.md
• outFile.md
• paths.md
• plugins.md
• sourceRoot.md
• strict.md
• target.md
• traceResolution.md
• Backwards_Compatibility_6253.md
• Compiler_Diagnostics_6251.md
• Completeness_6257.md
• Editor_Support_6249.md
• Emit_6246.md
• Interop_Constraints_6252.md
• JavaScript_Support_6247.md
• Language_and_Environment_6254.md
• Modules_6244.md
• Output_Formatting_6256.md
• Projects_6255.md
• Type_Checking_6248.md
• Watch_and_Build_Modes_6250.md
• help.md
• allowArbitraryExtensions.md
• allowImportingTsExtensions.md
• allowJs.md
• allowSyntheticDefaultImports.md
• allowUmdGlobalAccess.md
• allowUnreachableCode.md
• allowUnusedLabels.md
• assumeChangesOnlyAffectDirectDependencies.md
• checkJs.md
• clean.md
• customConditions.md
• declarationDir.md
• declarationMap.md
• diagnostics.md
• disableFilenameBasedTypeAcquisition.md
• disableReferencedProjectLoad.md
• disableSizeLimit.md
• disableSolutionSearching.md
• disableSourceOfProjectReferenceRedirect.md
• downlevelIteration.md
• emitBOM.md
• emitDeclarationOnly.md
• emitDecoratorMetadata.md
• enable.md
• esModuleInterop.md
• exactOptionalPropertyTypes.md
• excludeDirectories.md
• excludeFiles.md
• experimentalDecorators.md
• explainFiles.md
• extendedDiagnostics.md
• extends.md
• fallbackPolling.md
• force.md
• forceConsistentCasingInFileNames.md
• generateCpuProfile.md
• importHelpers.md
• importsNotUsedAsValues.md
• incremental.md
• inlineSourceMap.md
• inlineSources.md
• isolatedModules.md
• jsx.md
• jsxFactory.md
• keyofStringsOnly.md
• listEmittedFiles.md
• mapRoot.md
• maxNodeModuleJsDepth.md
• module.md
• moduleDetection.md
• moduleSuffixes.md
• noEmit.md
• noEmitHelpers.md
• noEmitOnError.md
• noErrorTruncation.md
• noFallthroughCasesInSwitch.md
• noImplicitOverride.md
• noImplicitReturns.md
• noImplicitThis.md
• noImplicitUseStrict.md
• noLib.md
• noPropertyAccessFromIndexSignature.md
• noStrictGenericChecks.md
• noUncheckedIndexedAccess.md
• noUnusedLocals.md
• noUnusedParameters.md
• preserveConstEnums.md
• preserveSymlinks.md
• preserveValueImports.md
• preserveWatchOutput.md
• pretty.md
• reactNamespace.md
• references.md
• removeComments.md
• resolveJsonModule.md
• resolvePackageJsonExports.md
• resolvePackageJsonImports.md
• rootDir.md
• rootDirs.md
• skipDefaultLibCheck.md
• skipLibCheck.md
• sourceMap.md
• strictBindCallApply.md
• strictFunctionTypes.md
• strictNullChecks.md
• strictPropertyInitialization.md
• stripInternal.md
• suppressExcessPropertyErrors.md
• suppressImplicitAnyIndexErrors.md
• synchronousWatchDirectory.md
• tsBuildInfoFile.md
• typeAcquisition.md
• typeRoots.md
• types.md
• useDefineForClassFields.md
• useUnknownInCatchVariables.md
• verbatimModuleSyntax.md
• verbose.md
• watchDirectory.md
• watchFile.md
• exclude.md
• include.md
• Top Level.md
• buildOptions.md
• compilerOptions.md
• typeAcquisition.md
• watchOptions.md

Website copy

Done: 2, TODO: 11.

• community.ts
• nav.ts
• cheatsheets.ts
• documentation.ts
• dt.ts
• en.ts
• footer.ts
• handbook.ts
• head-seo.ts
• index.ts
• index2.ts
• playground.ts
• tsconfig.ts

Documentation

Done: 60, TODO: 74.

• Nightly Builds.md
• By Example.md
• Consumption.md
• Deep Dive.md
• Do's and Don'ts.md
• Introduction.md
• Library Structures.md
• Publishing.md
• Templates.md
• module-class.d.ts.md
• module-function.d.ts.md
• TS for Functional Programmers.md
• TS for JS Programmers.md
• TS for OOPers.md
• TS for the New Programmer.md
• Basics.md
• Everyday Types.md
• More on Functions.md
• The Handbook.md
• Understanding Errors.md
• Conditional Types.md
• Generics.md
• Indexed Access Types.md
• Keyof Type Operator.md
• Mapped Types.md
• Typeof Type Operator.md
• Creating DTS files From JS.md
• Intro to JS with TS.md
• JSDoc Reference.md
• Type Checking JavaScript Files.md
• Compiler Options in MSBuild.md
• Compiler Options.md
• Configuring Watch.md
• Integrating with Build Tools.md
• Project References.md
• tsconfig.json.md
• Declaration Merging.md
• Decorators.md
• Enums.md
• Iterators and Generators.md
• JSX.md
• Namespaces and Modules.md
• Namespaces.md
• Symbols.md
• Triple-Slash Directives.md
• Type Compatibility.md
• Type Inference.md
• Utility Types.md
• Variable Declarations.md
• TypeScript 3.8.md
• TypeScript 3.9.md
• TypeScript 4.0.md
• TypeScript 4.9.md
• ASP.NET Core.md
• Babel with TypeScript.md
• DOM Manipulation.md
• Gulp.md
• Migrating from JavaScript.md
• React.md
• TypeScript Tooling in 5 minutes.md
• global-modifying-module.d.ts.md
• global-plugin.d.ts.md
• global.d.ts.md
• module-plugin.d.ts.md
• module.d.ts.md
• Basic Types.md
• Classes.md
• Functions.md
• Generics.md
• Interfaces.md
• Literal Types.md
• Unions and Intersections.md
• Classes.md
• Modules.md
• Narrowing.md
• Object Types.md
• Type Declarations.md
• Template Literal Types.md
• _Creating Types from Types.md
• Introduction.md
• Reference.md
• Theory.md
• ESM-CJS-Interop.md
• README
• declaration-files.svg
• esm-cjs-interop.md
• esm-cjs-interop.mmd-1.svg
• esm-cjs-interop.mmd-2.svg
• theory.md
• theory.md-1.svg
• theory.md-2.svg
• theory.md-3.svg
• theory.md-4.svg
• Choosing Compiler Options.md
• Advanced Types.md
• Mixins.md
• TypeScript 1.1.md
• TypeScript 1.3.md
• TypeScript 1.4.md
• TypeScript 1.5.md
• TypeScript 1.6.md
• TypeScript 1.7.md
• TypeScript 1.8.md
• TypeScript 2.0.md
• TypeScript 2.1.md
• TypeScript 2.2.md
• TypeScript 2.3.md
• TypeScript 2.4.md
• TypeScript 2.5.md
• TypeScript 2.6.md
• TypeScript 2.7.md
• TypeScript 2.8.md
• TypeScript 2.9.md
• TypeScript 3.0.md
• TypeScript 3.1.md
• TypeScript 3.2.md
• TypeScript 3.3.md
• TypeScript 3.4.md
• TypeScript 3.5.md
• TypeScript 3.6.md
• TypeScript 3.7.md
• TypeScript 4.1.md
• TypeScript 4.2.md
• TypeScript 4.3.md
• TypeScript 4.4.md
• TypeScript 4.5.md
• TypeScript 4.6.md
• TypeScript 4.7.md
• TypeScript 4.8.md
• TypeScript 5.0.md
• TypeScript 5.1.md
• TypeScript 5.2.md
• TypeScript 5.3.md
• Angular.md

[yahma25]

번역 담당하겠습니다~ 🚀

Playground

• Errors.ts
• Code Flow.ts
• Functions.ts 이미 완료된 상태여서 작업하지 않음

[yahma25]

번역 담당하겠습니다~ 🍰

Playground

• Objects and Arrays.ts
• Union and Intersection Types.ts
• Type Guards.ts

[danielsychoo]

안녕하세요👋🏻 이전에 번역 담당하기로 했었는데,
번역 완료로 인해 pr보내려 하니 이전 issue가 닫혀서
혼선이 없도록 다시한번 남깁니다. 😁

TSConfig Reference

• out.md
• outDir.md
• outFile.md

choointern@gmail.com

[yahma25]

번역 담당하겠습니다~ 🍬

Playground

• Assertion Functions.ts

[yeonjuan]

번역을 도와주시는 분들은 아래 용어집을 한번 확인해 주시면 감사하겠습니다 :) 용어집에 단어 추가가 필요할 경우 @yeonjuan 멘션과 함께 코멘트를 남겨주시면 감사하겠습니다.

용어집

원어	번역	설명
TypeScript type (string, number, any, etc...)	원문	TypeScript에서 사용하는 타입은 원문 그대로 사용합니다.
alias	별칭
ambient	ambient
annotate	표기하기
anonymous function	익명 함수
argument	인수
assertion	단언
base class	기초 클래스
dependency	의존성
export	export	모듈 export 설명시 원어 사용
identifier	식별자	\
import	import	모듈 import 설명시 원어 사용
JavaScript	JavaScript	원어 자체로 사용
TypeScript	TypeScript	원어 자체로 사용
method	메서드	국립국어원 발음표기에 따라 '메소드'가 아닌 '메서드'로 통일
modifier	지정자
optional	선택적
parameter	매개변수	인자라고 부르기도 함
property	프로퍼티
scope	스코프
statement	문
subclass	하위 클래스
superclass	상위 클래스
symbol	심벌	"심볼"은 잘못된 표현이니 주의
syntax	구문
type	타입	TypeScript 언어에서 지칭하는 타입의 경우 "타입"으로 번역, 그 외에는 유형', '모양', '생김새'등 번역해서 사용
type annotation	타입 표기
watch	watch	원어 자체로 사용
watcher	watcher	원어 자체로 사용
generic	제네릭
directory	디렉터리
vanilla	vanilla	원어 자체로 사용
type system	타입 시스템
object	객체
union	유니언
block	블록

[yahma25]

@yeonjuan
최근 "union"에 대하여 "유니온" -> "유니언"으로 피드백 받았습니다.
용어집에 추가되면 좋겠네요. 😃

[yahma25]

번역 담당하겠습니다~ 🍉

Playground

• Nullable Types.ts
• Tuples.ts

[yahma25]

번역 담당하겠습니다~ 🌮

Playground

• Generic Classes.ts
• Mixins.ts

[yahma25]

@cadenzah

안녕하세요, 저는 초보 번역자라 깊은 내용을 다루진 못하지만, 개인적인 의견을 남겨봅니다.
이번 기회에 저도 술어에 대해 살펴보게 되었는데, 덕분에 흥미롭게 생각해볼 수 있는 시간이었네요. 제안 감사합니다~ 👍

저는 술어(or 서술어, 서술자)에 의견을 내보겠습니다.
서술자, 판단자 등이 처음 봤을 때는 이해가 되긴 했는데, 좀 더 생각해보니 Type Predicate라는 것이 도구(-자)보단 개념에 가깝다고 느꼈습니다. 타입 가드 방식 중에 is라는 연산자를 사용하여 A가 B 타입인지(a is b type)를 판별할 수 있는 개념이요.

저희 팀에서도 타입 가드를 사용하는데 Type Predicate에 대해선 타입 가드 or is 연산자 둘 중 하나의 용어를 사용하여 소통하고 있습니다. 신입 분에게 타입 가드를 설명할 때만 Type Predicate를 언급했습니다.

이건 다른 관점으로, 검색 노출도를 높이기 위함입니다.
이미 언급 하신대로, 핸드북에서 번역 된 사례가 있으니, 같은/비슷한 키워드로 검색되어 보다 많은 사람이 타입스크립트 웹사이트(TypeScript Playground)로 유입되었으면 하는 바람입니다.

하지만, 저 역시 아래 말씀하신 부분도 동의합니다.

하지만, 오히려 지금 좋은 번역을 선택하고 커뮤니티가 수용한다면, 좀 더 대중적으로 사용될 수도 있겠다는 생각(과 기대)도 있습니다.

PS: 여기 번역 프로젝트는 참여자가 적으니 다른 커뮤니티의 의견을 받으면 참고가 많은 도움이 될 것 같네요. 😃

• 공유 @bumkeyy

[cadenzah]

@yahma25 좋은 의견 공유 너무나 감사드립니다.

위 글을 올리고 나서 몇몇 자료들을 검색해보고 또 Predicate Calculus에 대하여 찾아보며 "서술한다"에 대하여 이해해보고 나니, 말씀하신 것처럼 저도 판단자보다는 술어 쪽으로 다시 마음이 기울게 되더라고요. 제가 처음 서술자든 술어든 그 용어에 대하여 낯설게 느껴졌던 건 결국 익숙함의 차이가 큰 것이고(처음 보거나 뭔지 몰라서...), 계속 마주치고 또 뜻을 이해하다보면 점점 더 자연스럽게 느껴지지 않을까 싶은 생각도 듭니다.

그리고 링크해주신 핸드북 사례는 제가 미처 생각해보지 못했네요! 저러한 사례도 감안한다면 판단자보다는 술어가 더 유입에 도움이 될 것 같습니다.

[yahma25]

@yeonjuan @bumkeyy

안녕하세요. 틈틈이 시간 내주셔서 PR 리뷰해주시느라 수고 많으십니다. 😄

번역 리스트 관리에 대한 논의를 요청합니다.

현재 진행 상황을 체크할 수 있는 리스트(task/todo list)는 1. 위에 orta 분이 처음 작성한 것과 2. 구글 스프레드시트가 있는데요. 각각 문제점이 보이는 상황입니다.

문제

이곳의 task/todo list

• 각 task로 등록된 파일의 링크가 대부분 찾을 수 없는 페이지 상태(404)고 체크 상태도 갱신이 되지 않아서 어디까지 반영되었는지는 직접 확인하는 수밖에 없습니다.
  • TypeScript-Website에서 찾기
  • 현재 프로젝트 fork 후 IDE에서 찾기

구글 스프레드시트

• 노출이 안 돼서 지금은 저만 이용하는 것 같네요. 😥

번역 누락된 파일

• TypeScript-Website에서 merge 했었지만 누락된 케이스
• 여기 프로젝트로 새로 생성되면서 기존 PR이 closed 되어 누락된 케이스

개선(논의할 것)

1. 번역 리스트 관리는 구글 스프레드시트를 정기적으로 갱신해주면 될 것 같습니다.

   • 최신 버전으로 관리하는 데 제가 기여해볼 수 있을 것 같네요.
     • 새로 추가된 en 버전 소스 추가
     • 상태(Finished, Translating, Pull Request) 관리. 🤔 이 부분은 작업자 본인이 하는 것이 맞겠지만, 오랫동안 방치된 케이스는 직접 갱신

2. 번역 누락된 파일

   • 제가 작업했던 케이스는 다시 PR 등록하면 되는데, 다른 분이 작업했던 것은 찾아서 번역한 내용 그대로 PR 올리면 될 것으로 보입니다.

시간 여유가 되실 때 살펴봐 주시기 바랍니다. 🙏

[minsoo0715]

안녕하세요 release-notes 부분 쪽 번역하려고 합니다.

• Typescript 4.1.md

일단 이 부분부터 번역하겠습니다.

[proceane]

안녕하세요 번역 담당하겠습니다!

TSConfig Reference

• moduleResolution.md
• noResolve.md

[bumkeyy]

@yahma25

안녕하세요.

번역에 적극적으로 참여해주셔서 너무 감사하고 또 답변이 너무 늦어져서 죄송합니다.

일단 task/todo list 에서 링크는 이전 레포에서 백업해오면서 오류가 난 것으로 보입니다.
이건 관리자와 다시 한번 이야기해보겠습니다.

그런데 PR이 머지되면 체크가 되는 것으로 알고 있는데 현재 동작하지 않는 사례가 있나요????

두번째로 구글 스프레드 시트 또한 현재 관리가 제대로 되고 있지 않아서 재정리후에 다시 노출하도록 하겠습니다.

아 번역이 누락된 케이스는 그 당시 정책에 따라 적용되지 않고 close가 된 것으로 확인되는데로 다시 PR하거나 재번역을 할 수 있도록 진행하겠습니다.

좋은 의견 주셔서 감사합니다. 😄

[yahma25]

@bumkeyy
답변 감사합니다~

playground 중 맨 아래에 있는 두 개는 최근에 merged 상태인데 체크가 안되어 있어요.

• Discriminate Types.ts (merged)
• Indexed Types.ts (merged)

Mobile Support.ts 이것도 merged 상태인데 안되어 있네요.

task check 기능에 문제가 있나 보군요.
Actions > Weekly issue updates 시점에 bot이 정기적으로 갱신하나보네요.
정확한 로그는 찾아보지 못했네요 🤔

[MilkClouds]

https://typescript-kr.github.io/pages/tutorials/ts-for-oopers.html
파생 클래스와 파생 클래스의 기본 사이의 자연스러운 하위 타입 관계가 파괴되기 때문에, 하위 클래스는 삭제할 수 없습니다.
=>
파생 클래스와 파생 클래스의 기본 사이의 자연스러운 하위 타입 관계가 파괴되기 때문에, 하위 클래스의 프로퍼티는 삭제할 수 없습니다.

이런 사소한 오타를 고치고 싶은데 이런 경우 어떻게 해야 할까요?

[bumkeyy]

@MilkClouds

해당 레포는 현재 deprecated 되어 있습니다.

https://github.com/microsoft/TypeScript-Website-Localizations/blob/main/docs/documentation/ko/get-started/TS%20for%20OOPers.md

여기서 어색한 부분을 찾아서 PR 올려주세요 😄

[kasterra]

안녕하세요 번역 담당하겠습니다.
Documentation

- [ ] Narrowing.md(#131 에서 이미 번역된것을 확인)

• More on Functions.md (Translate 1 file to ko - More on Functions.md #150)
• Object Types.md

[KunHwanAhn]

여러분 덕분에 번역문서로 잘 공부하고 있습니다. 🙇‍♂️

문서를 보다보면 이탤릭체가 제대로 적용되지 않는 곳들이 종종 있어서 관련해서 이슈를 올렸는데, 여기에 한글 번역 관련 협업 이슈가 있는 것 확인하고 같이 링크 전달드립니다. 🙏

#167

[Jeongseulho]

안녕하세요 공부하던 중 다음 문서가 번역이 아직 안되어 있는데 담당해도 될까요?
TypeScript 5.0.md
TypeScript 5.1.md
TypeScript 5.2.md

[bluejoyq]

안녕하세요 번역 담당하겠습니다.

• _Creating Types from Types.md (Translate 1 file to ko - _Creating Types from Types.md #221)

[d0422]

안녕하세요
잘몰라서 PR을 올려버렸는데요,..!
module-reference의 theory를 번역하였습니다...!

• Theory.md #6 Translate module-reference/Theory.md to korean #224

[raymondanythings]

번역 담당하겠습니다!

declaration files - .d.ts Templates

• global.d.ts.md