Merge pull request microsoft#911 from microsoft/translatable

Adds translatable docs to the localization summary issues + Korean

Author: Orta Therox

.github/CODEOWNERS

@@ -27,4 +27,9 @@ packages/tsconfig-reference/copy/zh/**/*.md @Kingwl
 packages/typescriptlang-org/src/copy/zh/**/*.md @Kingwl
 packages/documentation/copy/zh/**/*.ts @Kingwl
 
-
+# Collaborators for Korean Translation of the Website
+packages/playground-examples/copy/ko/**/*.md @Bumkeyy
+packages/playground-examples/copy/ko/**/*.ts @Bumkeyy
+packages/tsconfig-reference/copy/ko/**/*.md @Bumkeyy
+packages/typescriptlang-org/src/copy/ko/**/*.md @Bumkeyy
+packages/documentation/copy/ko/**/*.ts @Bumkeyy

packages/documentation/copy/en/Nightly Builds.md

@@ -3,9 +3,10 @@ title: Nightly Builds
 layout: docs
 permalink: /docs/handbook/nightly-builds.html
 oneline: How to use a nightly build of TypeScript
+translatable: true
 ---
 
-A nightly build from the [TypeScript's `master`](https://github.com/Microsoft/TypeScript/tree/master) branch is published by midnight PST to npm and NuGet.
+A nightly build from the [TypeScript's `master`](https://github.com/Microsoft/TypeScript/tree/master) branch is published by midnight PST to npm.
 Here is how you can get it and use it with your tools.
 
 ## Using npm
@@ -14,18 +15,6 @@ Here is how you can get it and use it with your tools.
 npm install -g typescript@next
 ```
 
-## Using NuGet with MSBuild
-
-> Note: You'll need to configure your project to use the NuGet packages.
-> Please see [Configuring MSBuild projects to use NuGet](https://github.com/Microsoft/TypeScript/wiki/Configuring-MSBuild-projects-to-use-NuGet) for more information.
-
-The nightlies are available on [www.myget.org](https://www.myget.org/gallery/typescript-preview).
-
-There are two packages:
-
-- `Microsoft.TypeScript.Compiler`: Tools only (`tsc.exe`, `lib.d.ts`, etc.) .
-- `Microsoft.TypeScript.MSBuild`: Tools as above, as well as MSBuild tasks and targets (`Microsoft.TypeScript.targets`, `Microsoft.TypeScript.Default.props`, etc.)
-
 ## Updating your IDE to use the nightly builds
 
 You can also update your IDE to use the nightly drop.

packages/documentation/copy/en/javascript/Creating DTS files From JS.md

@@ -3,6 +3,7 @@ title: Creating .d.ts Files from .js files
 layout: docs
 permalink: /docs/handbook/declaration-files/dts-from-js.html
 oneline: "How to add d.ts generation to JavaScript projects"
+translatable: true
 ---
 
 [With TypeScript 3.7](/docs/handbook/release-notes/typescript-3-7.html#--declaration-and---allowjs),

packages/documentation/copy/en/javascript/Intro to JS with TS.md

@@ -3,6 +3,7 @@ title: JS Projects Utilizing TypeScript
 layout: docs
 permalink: /docs/handbook/intro-to-js-ts.html
 oneline: How to add type checking to JavaScript files using TypeScript
+translatable: true
 ---
 
 The type system in TypeScript has different levels of strictness when working with a codebase:

packages/documentation/copy/en/javascript/JSDoc Reference.md

@@ -3,6 +3,7 @@ title: JSDoc Reference
 layout: docs
 permalink: /docs/handbook/jsdoc-supported-types.html
 oneline: What JSDoc does TypeScript-powered JavaScript support?
+translatable: true
 ---
 
 The list below outlines which constructs are currently supported

packages/documentation/copy/en/project-config/Configuring Watch.md

@@ -3,6 +3,7 @@ title: Configuring Watch
 layout: docs
 permalink: /docs/handbook/configuring-watch.html
 oneline: How to configure the watch mode of TypeScript
+translatable: true
 ---
 
 Compiler supports configuring how to watch files and directories using compiler flags in TypeScript 3.8+, and environment variables before that.

packages/documentation/copy/en/project-config/Integrating with Build Tools.md

@@ -99,7 +99,7 @@ var out = path.join(__dirname, "output.js");
 Duo(__dirname)
   .entry("entry.ts")
   .use(typescript())
-  .run(function(err, results) {
+  .run(function (err, results) {
     if (err) throw err;
     // Write compiled result to output file
     fs.writeFileSync(out, results.code);
@@ -119,13 +119,13 @@ npm install grunt-ts
 ### Basic Gruntfile.js
 
 ```js
-module.exports = function(grunt) {
+module.exports = function (grunt) {
   grunt.initConfig({
     ts: {
       default: {
-        src: ["**/*.ts", "!node_modules/**/*.ts"]
-      }
-    }
+        src: ["**/*.ts", "!node_modules/**/*.ts"],
+      },
+    },
   });
   grunt.loadNpmTasks("grunt-ts");
   grunt.registerTask("default", ["ts"]);
@@ -148,11 +148,11 @@ npm install gulp-typescript
 var gulp = require("gulp");
 var ts = require("gulp-typescript");
 
-gulp.task("default", function() {
+gulp.task("default", function () {
   var tsResult = gulp.src("src/*.ts").pipe(
     ts({
       noImplicitAny: true,
-      out: "output.js"
+      out: "output.js",
     })
   );
   return tsResult.js.pipe(gulp.dest("built/local"));
@@ -188,17 +188,17 @@ module.exports = {
   entry: "./src/index.tsx",
   output: {
     path: "/",
-    filename: "bundle.js"
+    filename: "bundle.js",
   },
   resolve: {
-    extensions: [".tsx", ".ts", ".js", ".json"]
+    extensions: [".tsx", ".ts", ".js", ".json"],
   },
   module: {
     rules: [
       // all files with a '.ts' or '.tsx' extension will be handled by 'ts-loader'
-      { test: /\.tsx?$/, use: ["ts-loader"], exclude: /node_modules/ }
-    ]
-  }
+      { test: /\.tsx?$/, use: ["ts-loader"], exclude: /node_modules/ },
+    ],
+  },
 };
 ```
 
@@ -208,18 +208,18 @@ module.exports = {
 module.exports = {
   entry: "./src/index.tsx",
   output: {
-    filename: "bundle.js"
+    filename: "bundle.js",
   },
   resolve: {
     // Add '.ts' and '.tsx' as a resolvable extension.
-    extensions: ["", ".webpack.js", ".web.js", ".ts", ".tsx", ".js"]
+    extensions: ["", ".webpack.js", ".web.js", ".ts", ".tsx", ".js"],
   },
   module: {
     rules: [
       // all files with a '.ts' or '.tsx' extension will be handled by 'ts-loader'
-      { test: /\.tsx?$/, loader: "ts-loader" }
-    ]
-  }
+      { test: /\.tsx?$/, loader: "ts-loader" },
+    ],
+  },
 };
 ```
 

packages/documentation/copy/en/project-config/Project References.md

@@ -3,6 +3,7 @@ title: Project References
 layout: docs
 permalink: /docs/handbook/project-references.html
 oneline: How to split up a large TypeScript project
+translatable: true
 ---
 
 Project references are a new feature in TypeScript 3.0 that allow you to structure your TypeScript programs into smaller pieces.

packages/documentation/copy/en/project-config/tsconfig.json.md

@@ -3,6 +3,7 @@ title: tsconfig.json
 layout: docs
 permalink: /docs/handbook/tsconfig-json.html
 oneline: Learn about how a TSConfig works
+translatable: true
 ---
 
 ## Overview

packages/documentation/copy/en/reference/Declaration Merging.md

@@ -3,6 +3,7 @@ title: Declaration Merging
 layout: docs
 permalink: /docs/handbook/declaration-merging.html
 oneline: How merging namespaces and interfaces works
+translatable: true
 ---
 
 ## Introduction
@@ -227,7 +228,7 @@ Similarly, namespaces can be used to extend enums with static members:
 enum Color {
   red = 1,
   green = 2,
-  blue = 4
+  blue = 4,
 }
 
 namespace Color {
@@ -264,7 +265,7 @@ export class Observable<T> {
 
 // map.ts
 import { Observable } from "./observable";
-Observable.prototype.map = function(f) {
+Observable.prototype.map = function (f) {
   // ... another exercise for the reader
 };
 ```
@@ -285,15 +286,15 @@ declare module "./observable" {
     map<U>(f: (x: T) => U): Observable<U>;
   }
 }
-Observable.prototype.map = function(f) {
+Observable.prototype.map = function (f) {
   // ... another exercise for the reader
 };
 
 // consumer.ts
 import { Observable } from "./observable";
 import "./map";
 let o: Observable<number>;
-o.map(x => x.toFixed());
+o.map((x) => x.toFixed());
 ```
 
 The module name is resolved the same way as module specifiers in `import`/`export`.
@@ -321,7 +322,7 @@ declare global {
   }
 }
 
-Array.prototype.toObservable = function() {
+Array.prototype.toObservable = function () {
   // ...
 };
 ```

packages/documentation/copy/en/reference/Decorators.md

@@ -3,6 +3,7 @@ title: Decorators
 layout: docs
 permalink: /docs/handbook/decorators.html
 oneline: TypeScript Decorators overview
+translatable: true
 ---
 
 ## Introduction
@@ -57,7 +58,7 @@ We can write a decorator factory in the following fashion:
 ```ts
 function color(value: string) {
   // this is the decorator factory
-  return function(target) {
+  return function (target) {
     // this is the decorator
     // do something with 'target' and 'value'...
   };
@@ -96,14 +97,22 @@ If we were to use [decorator factories](#decorator-factories), we can observe th
 ```ts
 function f() {
   console.log("f(): evaluated");
-  return function(target, propertyKey: string, descriptor: PropertyDescriptor) {
+  return function (
+    target,
+    propertyKey: string,
+    descriptor: PropertyDescriptor
+  ) {
     console.log("f(): called");
   };
 }
 
 function g() {
   console.log("g(): evaluated");
-  return function(target, propertyKey: string, descriptor: PropertyDescriptor) {
+  return function (
+    target,
+    propertyKey: string,
+    descriptor: PropertyDescriptor
+  ) {
     console.log("g(): called");
   };
 }
@@ -234,7 +243,7 @@ We can define the `@enumerable` decorator using the following function declarati
 
 ```ts
 function enumerable(value: boolean) {
-  return function(
+  return function (
     target: any,
     propertyKey: string,
     descriptor: PropertyDescriptor
@@ -296,7 +305,7 @@ We can define the `@configurable` decorator using the following function declara
 
 ```ts
 function configurable(value: boolean) {
-  return function(
+  return function (
     target: any,
     propertyKey: string,
     descriptor: PropertyDescriptor
@@ -422,7 +431,7 @@ function validate(
   descriptor: TypedPropertyDescriptor<Function>
 ) {
   let method = descriptor.value;
-  descriptor.value = function() {
+  descriptor.value = function () {
     let requiredParameters: number[] = Reflect.getOwnMetadata(
       requiredMetadataKey,
       target,
@@ -522,7 +531,7 @@ function validate<T>(
   descriptor: TypedPropertyDescriptor<T>
 ) {
   let set = descriptor.set;
-  descriptor.set = function(value: T) {
+  descriptor.set = function (value: T) {
     let type = Reflect.getMetadata("design:type", target, propertyKey);
     if (!(value instanceof type)) {
       throw new TypeError("Invalid type.");

packages/documentation/copy/en/reference/Iterators and Generators.md

@@ -3,6 +3,7 @@ title: Iterators and Generators
 layout: docs
 permalink: /docs/handbook/iterators-and-generators.html
 oneline: How Iterators and Generators work in TypeScript
+translatable: true
 ---
 
 ## Iterables

packages/documentation/copy/en/reference/JSX.md

@@ -3,6 +3,7 @@ title: JSX
 layout: docs
 permalink: /docs/handbook/jsx.html
 oneline: Using JSX with TypeScript
+translatable: true
 ---
 
 [JSX](https://facebook.github.io/jsx/) is an embeddable XML-like syntax.

packages/documentation/copy/en/reference/Mixins.md

@@ -3,6 +3,7 @@ title: Mixins
 layout: docs
 permalink: /docs/handbook/mixins.html
 oneline: Using the mixin pattern with TypeScript
+translatable: true
 ---
 
 Along with traditional OO hierarchies, another popular way of building up classes from reusable components is to build them by combining simpler partial classes.

packages/documentation/copy/en/reference/Module Resolution.md

@@ -3,6 +3,7 @@ title: Module Resolution
 layout: docs
 permalink: /docs/handbook/module-resolution.html
 oneline: How TypeScript resolves modules in JavaScript
+translatable: true
 ---
 
 > This section assumes some basic knowledge about modules.