Finish basics

Author: xcatliu

SUMMARY.md

@@ -9,7 +9,7 @@
   - [原始数据类型](basics/primitive-data-types.md)
   - [任意值（Any）](basics/any.md)
   - [类型推论](basics/type-inference.md)
-  - [联合类型（Union Types）](basics/union-types.md)
+  - [联合类型](basics/union-types.md)
   - [对象的类型——接口](basics/type-of-object-interfaces.md)
   - [数组的类型](basics/type-of-array.md)
   - [函数的类型](basics/type-of-function.md)

basics/README.md

@@ -5,7 +5,7 @@
 - [原始数据类型](primitive-data-types.md)
 - [任意值（Any）](any.md)
 - [类型推论](type-inference.md)
-- [联合类型（Union Types）](union-types.md)
+- [联合类型](union-types.md)
 - [对象的类型——接口](type-of-object-interfaces.md)
 - [数组的类型](type-of-array.md)
 - [函数的类型](type-of-function.md)

basics/any.md

@@ -65,5 +65,4 @@ something.setName('Jerry Lee');
 
 ## 参考
 
-- [Handbook - Basic Types # Any](http://www.typescriptlang.org/docs/handbook/basic-types.html#any)
-- [中文手册 - 基础类型 # 任意值](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#任意值)
+- [Handbook - Basic Types # Any](http://www.typescriptlang.org/docs/handbook/basic-types.html#any) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#任意值)

basics/built-in-objects.md

@@ -88,7 +88,15 @@ interface Document extends Node, GlobalEventHandlers, NodeSelector, DocumentEven
 
 查看 TypeScript 核心库的定义：[TypeScript 核心库的定义文件]。
 
-需要注意的是，TypeScript 核心库的定义中不包含 Node.js 部分。如果要在 Node.js 中使用 TypeScript，可以参考？？？一章。
+需要注意的是，TypeScript 核心库的定义中不包含 Node.js 部分。
+
+## 用 TypeScript 写 Node.js
+
+Node.js 不是内置对象的一部分，如果想用 TypeScript 写 Node.js，则需要引入第三方声明文件：
+
+```shell
+npm install @types/node --save-dev
+```
 
 ## Links
 

basics/declaration-files.md

@@ -36,9 +36,9 @@ jQuery('#foo');
 declare var jQuery: (string) => any;
 ```
 
-> Tip: 我们约定声明文件以 `.d.ts` 为后缀。
+> 我们约定声明文件以 `.d.ts` 为后缀。
 
-然后在使用到的文件的开头，用「三斜线指令」表示引用的声明文件：
+然后在使用到的文件的开头，用「三斜线指令」表示引用了声明文件：
 
 ```ts
 /// <reference path="./jQuery.d.ts" />
@@ -50,15 +50,23 @@ jQuery('#foo');
 
 ## 第三方声明文件
 
-当然，jQuery 的声明文件不需要我们定义了，已经有人帮我们定义好了：[jquery.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/jquery/jquery.d.ts)。
+当然，jQuery 的声明文件不需要我们定义了，已经有人帮我们定义好了：[jQuery in DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/jquery)。
 
-我们可以下载下来使用，也可以使用 `typing` 方便的获取任何第三方库的声明文件。
+我们可以直接下载下来使用，但是更推荐的是使用工具统一管理第三方库的声明文件。
 
-关于 `typing` 的使用方法，可以参考？？？一章。
+社区已经有多种方式引入声明文件，不过 [TypeScript 2.0 推荐使用 @types 来管理](https://blogs.msdn.microsoft.com/typescript/2016/06/15/the-future-of-declaration-files/)。
+
+@types 的使用方式很简单，直接用 npm 安装对应的声明模块即可，以 jQuery 举例：
+
+```shell
+npm install @types/jquery --save-dev
+```
+
+可以在[这个页面](http://microsoft.github.io/TypeSearch/)搜索你需要的声明文件。
+
+更多关于 @types 的使用方法，可以参考？？？一章。
 
 ## Links
 
-- [Handbook - Writing Declaration Files](http://www.typescriptlang.org/docs/handbook/writing-declaration-files.html)
-- [中文手册 - 书写 d.ts 文件](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Writing%20Definition%20Files.html)
-- [Handbook - Triple-Slash Directives](http://www.typescriptlang.org/docs/handbook/triple-slash-directives.html)
-- [中文手册 - 三斜线指令](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Triple-Slash%20Directives.html)
+- [Handbook - Writing Declaration Files](http://www.typescriptlang.org/docs/handbook/writing-declaration-files.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Writing%20Definition%20Files.html)
+- [Handbook - Triple-Slash Directives](http://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Triple-Slash%20Directives.html)

basics/primitive-data-types.md

@@ -145,8 +145,7 @@ let num: number = u;
 
 ## 参考
 
-- [Handbook - Basic Types](http://www.typescriptlang.org/docs/handbook/basic-types.html)
-- [中文手册 - 基础类型](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html)
+- [Handbook - Basic Types](http://www.typescriptlang.org/docs/handbook/basic-types.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html)
 - [Primitive data types][]
 - [ES2015 中的新类型 `Symbol`][]
 - [ES2015 中的二进制和八进制表示法][]

basics/type-inference.md

@@ -1,6 +1,6 @@
 # 类型推论
 
-如果没有明确的指定类型，那么 TypeScript 会依照类型推论的规则推断出一个类型。
+如果没有明确的指定类型，那么 TypeScript 会依照类型推论（Type Inference）的规则推断出一个类型。
 
 ## 什么是类型推论
 
@@ -32,7 +32,6 @@ myFavoriteNumber = 'seven';
 myFavoriteNumber = 7;
 ```
 
-## Links
+## 参考
 
-- [Handbook - Type Inference](http://www.typescriptlang.org/docs/handbook/type-inference.html)
-- [中文手册 - 类型推论](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Inference.html)
+- [Handbook - Type Inference](http://www.typescriptlang.org/docs/handbook/type-inference.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Type%20Inference.html)

basics/type-of-array.md

@@ -1,10 +1,10 @@
 # 数组的类型
 
-数组类型有多种定义方式，比较灵活。
+在 TypeScript 中，数组类型有多种定义方式，比较灵活。
 
-## 「类型+方括号」表示法
+## 「类型 + 方括号」表示法
 
-最简单的方法是使用「类型+方括号」来表示数组：
+最简单的方法是使用「类型 + 方括号」来表示数组：
 
 ```ts
 let fibonacci: number[] = [1, 1, 2, 3, 5];
@@ -81,16 +81,9 @@ function sum() {
 }
 ```
 
-> Tip: 一般我们使用 `Array.prototype.slice.call(argumants)` 或 `[].slice.call(argumants)` 来将一个类数组转化为数组。ES6 中可以使用 [Array.from][ES6 中的 Array.from] 或者 [rest 参数][ES6 中的 rest 参数]实现类似功能。
+关于内建类型，可以参考[内置对象](./built-in-objects.md)一章。
 
 ## Links
 
-- [Handbook - Basic Types # Array](http://www.typescriptlang.org/docs/handbook/basic-types.html#array)
-- [Handbook - Interfaces # Indexable Types](http://www.typescriptlang.org/docs/handbook/interfaces.html#indexable-types)
-- [中文手册 - 基础类型 # 数组](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#数组)
-- [中文手册 - 接口 # 数组类型](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html#数组类型)
-- [ES6 中的 Array.from]
-- [ES6 中的 rest 参数]
-
-[ES6 中的 Array.from]: http://es6.ruanyifeng.com/#docs/array#Array-from
-[ES6 中的 rest 参数]: http://es6.ruanyifeng.com/#docs/function#rest参数
+- [Handbook - Basic Types # Array](http://www.typescriptlang.org/docs/handbook/basic-types.html#array) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Basic%20Types.html#数组)
+- [Handbook - Interfaces # Indexable Types](http://www.typescriptlang.org/docs/handbook/interfaces.html#indexable-types) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html#数组类型)

basics/type-of-function.md

@@ -1,6 +1,6 @@
 # 函数的类型
 
-> [函数是 JavaScript 中的一等公民。](https://llh911001.gitbooks.io/mostly-adequate-guide-chinese/content/ch2.html)
+> [函数是 JavaScript 中的一等公民](https://llh911001.gitbooks.io/mostly-adequate-guide-chinese/content/ch2.html)
 
 ## 函数声明（Function Declaration）
 
@@ -66,11 +66,11 @@ let mySum: (x: number, y: number) => number = function (x: number, y: number): n
 
 在 TypeScript 的类型定义中，`=>` 用来表示函数的定义，左边是输入类型，需要用括号括起来，右边是输出类型。
 
-> Tip: `=>` 在 ES6 中叫箭头函数，应用十分广泛，可以参考 [ES6 中的箭头函数]。
+其中，`=>` 在 ES6 中叫箭头函数，应用十分广泛，可以参考 [ES6 中的箭头函数]。
 
 ## 接口中函数的定义
 
-在接口中，需要这样定义一个函数：
+我们也可以使用接口的方式来定义一个函数需要符合的形状：
 
 ```ts
 interface SearchFunc {
@@ -92,7 +92,7 @@ mySearch = function(source: string, subString: string) {
 ```ts
 function buildName(firstName: string, lastName?: string) {
   if (lastName) {
-    return firstName + " " + lastName;
+    return firstName + ' ' + lastName;
   } else {
     return firstName;
   }
@@ -106,7 +106,7 @@ let xcat = buildName('Xcat');
 ```ts
 function buildName(firstName?: string, lastName: string) {
   if (firstName) {
-    return firstName + " " + lastName;
+    return firstName + ' ' + lastName;
   } else {
     return lastName;
   }
@@ -123,7 +123,7 @@ let xcat = buildName(undefined, 'Xcat');
 
 ```ts
 function buildName(firstName: string, lastName: string = 'Liu') {
-  return firstName + " " + lastName;
+  return firstName + ' ' + lastName;
 }
 let xcatliu = buildName('Xcat', 'Liu');
 let xcat = buildName('Xcat');
@@ -133,7 +133,7 @@ let xcat = buildName('Xcat');
 
 ```ts
 function buildName(firstName: string = 'Xcat', lastName: string) {
-  return firstName + " " + lastName;
+  return firstName + ' ' + lastName;
 }
 let xcatliu = buildName('Xcat', 'Liu');
 let xcat = buildName(undefined, 'Xcat');
@@ -169,14 +169,12 @@ let a = [];
 push(a, 1, 2, 3);
 ```
 
-> Tip: 注意 rest 参数只能是最后一个参数，关于 rest 参数，可以参考 [ES6 中的 rest 参数]。
+注意，rest 参数只能是最后一个参数，关于 rest 参数，可以参考 [ES6 中的 rest 参数]。
 
-## Links
+## 参考
 
-- [Handbook - Functions](http://www.typescriptlang.org/docs/handbook/functions.html)
-- [Handbook - Functions # Function Types](http://www.typescriptlang.org/docs/handbook/interfaces.html#function-types)
-- [中文手册 - 函数](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Functions.html)
-- [中文手册 - 接口 # 函数类型](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html#函数类型)
+- [Handbook - Functions](http://www.typescriptlang.org/docs/handbook/functions.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Functions.html)
+- [Handbook - Functions # Function Types](http://www.typescriptlang.org/docs/handbook/interfaces.html#function-types) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html#函数类型)
 - [JS 函数式编程指南](https://llh911001.gitbooks.io/mostly-adequate-guide-chinese/content/)
 - [ES6 中的箭头函数]
 - [ES6 中函数参数的默认值]

basics/type-of-object-interfaces.md

@@ -1,12 +1,12 @@
 # 对象的类型——接口
 
-使用接口（Interfaces）来定义对象的类型。
+在 TypeScript 中，我们使用接口（Interfaces）来定义对象的类型。
 
 ## 什么是接口（Interfaces）
 
 在面向对象语言中，接口（Interfaces）是一个很重要的概念，它是对行为的抽象，而具体如何行动需要由类（classes）去实现（implements）。
 
-TypeScript 中的接口是一个非常灵活的概念，除了可用于[对类的一部分行为进行抽象](../advanced/use-of-class.md#实现接口)以外，也常用于对「对象的形状（Shape）」进行描述，想了解接口的所有用法，可以参考？？？。
+TypeScript 中的接口是一个非常灵活的概念，除了可用于[对类的一部分行为进行抽象](../advanced/use-of-class.md#实现接口)以外，也常用于对「对象的形状（Shape）」进行描述。
 
 ## 简单的例子
 
@@ -24,7 +24,7 @@ let xcatliu: Person = {
 
 上面的例子中，我们定义了一个接口 `Person`，接着定义了一个变量 `xcatliu`，它的类型是 `Person`。这样，我们就约束了 `xcatliu` 的形状必须和接口 `Person` 一致。
 
-> Tip: 接口的定义一般首字母大写。
+接口一般首字母大写。
 
 如果定义的变量比接口少了一些属性会怎么样呢？
 
@@ -105,8 +105,8 @@ let xcatliu: Person = {
   website: 'http://xcatliu.com',
 };
 
-// index.ts(9,3): error TS2322: Type '{ name: string; age: number; github: string; }' is not assignable to type 'Person'.
-//   Object literal may only specify known properties, and 'github' does not exist in type 'Person'
+// examples/playground/index.ts(9,3): error TS2322: Type '{ name: string; age: number; website: string; }' is not assignable to type 'Person'.
+//   Object literal may only specify known properties, and 'website' does not exist in type 'Person'.
 ```
 
 由此可见，即使有可选属性，也不可以添加未定义的属性。
@@ -156,7 +156,6 @@ let xcatliu: Person = {
 
 另外，在报错信息中可以看出，此时 `{ name: 'Xcat Liu', age: 25, website: 'http://xcatliu.com' }` 的类型被推断成了 `{ [x: string]: string | number; name: string; age: number; github: string; }`，这是联合类型和接口的结合。
 
-## Links
+## 参考 
 
-- [Handbook - Interfaces](http://www.typescriptlang.org/docs/handbook/interfaces.html)
-- [中文手册 - 接口](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html)
+- [Handbook - Interfaces](http://www.typescriptlang.org/docs/handbook/interfaces.html) | [中文版](https://zhongsp.gitbooks.io/typescript-handbook/content/doc/handbook/Interfaces.html)