9 files changed, 44 insertions, 43 deletions

diff --git a/zh-cn/c-cn.html.markdown b/zh-cn/c-cn.html.markdown
index 8eecc56e..dbad5030 100644
--- a/zh-cn/c-cn.html.markdown
+++ b/zh-cn/c-cn.html.markdown
@@ -128,7 +128,7 @@ printf("Enter the array size: "); // 询问用户数组长度
 char buf[0x100];
 fgets(buf, sizeof buf, stdin);
 
-// stroul 将字符串解析为无符号整数
+// strtoul 将字符串解析为无符号整数
 size_t size = strtoul(buf, NULL, 10);
 int var_length_array[size]; // 声明VLA
 printf("sizeof array = %zu\n", sizeof var_length_array);
@@ -616,7 +616,7 @@ typedef void (*my_fnp_type)(char *);
 
 如果你有问题，请阅读[compl.lang.c Frequently Asked Questions](http://c-faq.com/)。
 
-使用合适的空格、缩进，保持一致的代码风格非常重要。可读性强的代码比聪明的代码、高速的代码更重要。可以参考下[Linux内核编码风格](https://www.kernel.org/doc/Documentation/CodingStyle)
+使用合适的空格、缩进，保持一致的代码风格非常重要。可读性强的代码比聪明的代码、高速的代码更重要。可以参考下[Linux内核编码风格](https://www.kernel.org/doc/Documentation/process/coding-style.rst)
 。
 除了这些，多多Google吧
 
diff --git a/zh-cn/go-cn.html.markdown b/zh-cn/go-cn.html.markdown
index 37b4b137..2953acf3 100644
--- a/zh-cn/go-cn.html.markdown
+++ b/zh-cn/go-cn.html.markdown
@@ -40,7 +40,7 @@ import (
 func main() {
     // 往标准输出打印一行。
     // 用包名fmt限制打印函数。
-    fmt.Println("天坑欢迎你!")
+    fmt.Println("你好世界")
 
     // 调用当前包的另一个函数。
     beyondHello()
diff --git a/zh-cn/haskell-cn.html.markdown b/zh-cn/haskell-cn.html.markdown
index c854169e..d653c58c 100644
--- a/zh-cn/haskell-cn.html.markdown
+++ b/zh-cn/haskell-cn.html.markdown
@@ -128,7 +128,7 @@ snd ("haskell", 1) -- 1
 -- 一个接受两个变量的简单函数
 add a b = a + b
 
--- 注意，如果你使用 ghci (Hakell 解释器)，你需要使用 `let`，也就是
+-- 注意，如果你使用 ghci (Haskell 解释器)，你需要使用 `let`，也就是
 -- let add a b = a + b
 
 -- 调用函数
diff --git a/zh-cn/java-cn.html.markdown b/zh-cn/java-cn.html.markdown
index 27003f3e..1de7f3e6 100644
--- a/zh-cn/java-cn.html.markdown
+++ b/zh-cn/java-cn.html.markdown
@@ -297,8 +297,8 @@ class Bicycle {
     // Bicycle 类的成员变量和方法
     public int cadence; // Public: 任意位置均可访问
     private int speed;  // Private: 只在同类中可以访问
-    protected int gear; // Protected: 可以在同类与子类中可以访问
-    String name; // default: 可以在包内中可以访问
+    protected int gear; // Protected: 可以在同类与子类中访问
+    String name; // default: 可以在包内访问
 
     // 构造函数是初始化一个对象的方式
     // 以下是一个默认构造函数
diff --git a/zh-cn/make-cn.html.markdown b/zh-cn/make-cn.html.markdown
index 76dde941..641714ef 100644
--- a/zh-cn/make-cn.html.markdown
+++ b/zh-cn/make-cn.html.markdown
@@ -23,7 +23,7 @@ Makefile 用于定义如何创建目标文件, 比如如何从源码到可执行
 ```make
 # 这行表示注释
 
-# 文件名一定要交 Makefile, 大小写区分, 使用 `make <target>` 生成 target
+# 文件名一定要叫 Makefile, 大小写区分, 使用 `make <target>` 生成 target
 # 如果想要取别的名字, 可以用 `make -f "filename" <target>`.
 
 # 重要的事情 - 只认识 TAB, 空格是不认的, 但是在 GNU Make 3.82 之后, 可以通过
@@ -87,7 +87,7 @@ ex0.txt ex1.txt: maker
 maker:
 	touch ex0.txt ex1.txt
 
-# 如果定义的 phony target 与文件名重名, 可以用 .PHONY 显示的指明哪些 targets 是 phony
+# 如果定义的 phony target 与文件名重名, 可以用 .PHONY 显式地指明哪些 targets 是 phony
 .PHONY: all maker process
 # This is a special target. There are several others.
 
@@ -116,7 +116,7 @@ process: ex1.txt file0.txt
 # 模式匹配
 #-----------------------------------------------------------------------
 
-# 可以让 make 知道如何转换某些文件到别格式
+# 可以让 make 知道如何转换某些文件到其他格式
 # 比如 从 svg 到 png
 %.png: %.svg
 	inkscape --export-png $^
@@ -149,7 +149,7 @@ echo:
 	@echo $(name)
 	@echo ${name2}
 	@echo $name    # 这个会被蠢蠢的解析成 $(n)ame.
-	@echo \"$(name3)\" # 为声明的变量或扩展成空字符串.
+	@echo \"$(name3)\" # 未声明的变量会被处理成空字符串.
 	@echo $(name4)
 	@echo $(name5)
 # 你可以通过4种方式设置变量.
diff --git a/zh-cn/perl-cn.html.markdown b/zh-cn/perl-cn.html.markdown
index 5b0d6179..4421da6e 100644
--- a/zh-cn/perl-cn.html.markdown
+++ b/zh-cn/perl-cn.html.markdown
@@ -10,9 +10,9 @@ translators:
 lang: zh-cn
 ---
 
-Perl 5是一个功能强大、特性齐全的编程语言，有25年的历史。
+Perl 是一个功能强大、特性齐全的编程语言，有25年的历史。
 
-Perl 5可以在包括便携式设备和大型机的超过100个平台上运行，既适用于快速原型构建，也适用于大型项目开发。
+Perl 可以在包括便携式设备和大型机的超过100个平台上运行，既适用于快速原型构建，也适用于大型项目开发。
 
 ```perl
 # 单行注释以#号开头
diff --git a/zh-cn/python-cn.html.markdown b/zh-cn/python-cn.html.markdown
index da13275b..6c5556fc 100644
--- a/zh-cn/python-cn.html.markdown
+++ b/zh-cn/python-cn.html.markdown
@@ -436,9 +436,9 @@ all_the_args(1, 2, a=3, b=4) prints:
 # 调用可变参数函数时可以做跟上面相反的，用*展开序列，用**展开字典。
 args = (1, 2, 3, 4)
 kwargs = {"a": 3, "b": 4}
-all_the_args(*args)   # 相当于 foo(1, 2, 3, 4)
-all_the_args(**kwargs)   # 相当于 foo(a=3, b=4)
-all_the_args(*args, **kwargs)   # 相当于 foo(1, 2, 3, 4, a=3, b=4)
+all_the_args(*args)   # 相当于 all_the_args(1, 2, 3, 4)
+all_the_args(**kwargs)   # 相当于 all_the_args(a=3, b=4)
+all_the_args(*args, **kwargs)   # 相当于 all_the_args(1, 2, 3, 4, a=3, b=4)
 
 
 # 函数作用域
diff --git a/zh-cn/pythonlegacy-cn.html.markdown b/zh-cn/pythonlegacy-cn.html.markdown
index 756081d6..f8aa2332 100644
--- a/zh-cn/pythonlegacy-cn.html.markdown
+++ b/zh-cn/pythonlegacy-cn.html.markdown
@@ -163,7 +163,7 @@ li[:3]  # => [1, 2, 4]
 del li[2]  # li 现在是 [1, 2, 3]
 
 # 合并列表
-li + other_li  # => [1, 2, 3, 4, 5, 6] - 并不会不改变这两个列表
+li + other_li  # => [1, 2, 3, 4, 5, 6] - 并不会改变这两个列表
 
 # 通过拼接来合并列表
 li.extend(other_li)  # li 是 [1, 2, 3, 4, 5, 6]
diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 7b6ff305..cfa22dfb 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -5,27 +5,27 @@ contributors:
 translators:
   - ["Zach Zhang", "https://github.com/checkcheckzz"]
   - ["Jiang Haiyun", "https://github.com/haiiiiiyun"]
+  - ["Wen Sun", "https://github.com/HermitSun"]
 filename: learnyaml-cn.yaml
 lang: zh-cn
 ---
 
-YAML 是一个数据序列化语言，被设计成人类直接可写可读的。
+YAML 是一种数据序列化语言，旨在让人类直接可写可读。
 
-它是 JSON 的严格超集，增加了语法显著换行符和缩进，就像 Python。但和 Python 不一样，
-YAML 根本不容许文字制表符。
+它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant）换行符和缩进，就像 Python 一样。但和 Python 的不同之处在于，YAML 不允许使用*文字制表符*（literal tab characters）来表示缩进。
 
 
 ```yaml
 ---  # 文档开头
 
-# YAML 中的注解看起来像这样。
+# YAML 中的注释看起来像这样。
 
 ################
 # 标量类型     #
 ################
 
-# 我们的根对象 (它们在整个文件里延续) 将会是一个映射，
-# 它等价于在别的语言里的一个字典，哈希表或对象。
+# 我们的根对象 (贯穿整个文档的始终) 是一个映射（map），
+# 它等价于其它语言中的一个字典（dictionary），哈希表（hash）或对象（object）。
 key: value
 another_key: Another value goes here.
 a_number_value: 100
@@ -35,16 +35,16 @@ scientific_notation: 1e+12
 boolean: true
 null_value: null
 key with spaces: value
-# 注意，字符串不必被括在引号中，但也可以被括起来。
+# 注意，字符串可以不括在引号里。当然，也可以括在引号里。
 however: 'A string, enclosed in quotes.'
 'Keys can be quoted too.': "Useful if you want to put a ':' in your key."
 single quotes: 'have ''one'' escape pattern'
 double quotes: "have many: \", \0, \t, \u263A, \x0d\x0a == \r\n, and more."
-# UTF-8/16/32 字符需要被转义(encoded)
+# UTF-8/16/32字符需要指明编码（通过\u）。
 Superscript two: \u00B2
 
-# 多行字符串既可以写成像一个'文字块'(使用 |)，
-# 或像一个'折叠块'(使用 '>')。
+# 多行字符串既可以写成一个'字面量块'(使用 '|')，
+# 也可以写成一个'折叠块'(使用 '>')。
 literal_block: |
     This entire block of text will be the value of the 'literal_block' key,
     with line breaks being preserved.
@@ -67,7 +67,7 @@ folded_style: >
 # 集合类型         #
 ####################
 
-# 嵌套是通过缩进完成的。推荐使用 2 个空格的缩进（但非必须）
+# 嵌套是通过缩进完成的。推荐使用 2 个空格的缩进（但非必须）。
 a_nested_map:
   key: value
   another_key: Another Value
@@ -77,22 +77,22 @@ a_nested_map:
 # 映射的键不必是字符串。
 0.25: a float key
 
-# 键也可以是复合型的，比如多行对象
-# 我们用 ? 后跟一个空格来表示一个复合键的开始。
+# 键也可以是复合（complex）的，比如多行对象
+# 我们用 '?' 后跟一个空格来表示一个复合键的开始。
 ? |
   This is a key
   that has multiple lines
 : and this is its value
 
 # YAML 也允许使用复杂键语法表示序列间的映射关系。
-# 但有些语言的解析器可能会不支持。
+# 但有些解析器可能会不支持。
 # 一个例子：
 ? - Manchester United
   - Real Madrid
 : [ 2001-01-01, 2002-02-02 ]
 
-# 序列 (等价于列表或数组) 看起来像这样：
-# 注意 '-' 算作缩进
+# 序列 (sequences，等价于列表 list 或数组 array ) 看起来像这样：
+# 注意 '-' 也算缩进：
 a_sequence:
   - Item 1
   - Item 2
@@ -115,7 +115,7 @@ and quotes are optional: {key: [3, 2, 1, takeoff]}
 # 其余的 YAML 特性    #
 #######################
 
-# YAML 还有一个方便的特性叫 '锚'，它能让你很容易在文档中进行文本复用。
+# YAML 还有一个方便的特性叫“锚”（anchors）。你可以使用它在文档中轻松地完成文本复用。
 # 如下两个键会有相同的值：
 anchored_content: &anchor_name This string will appear as the value of two keys.
 other_anchor: *anchor_name
@@ -124,8 +124,8 @@ other_anchor: *anchor_name
 base: &base
   name: Everyone has same name
 
-# The regexp << is called Merge Key Language-Independent Type.
-# 它表明指定映射的所有键值会插入到当前的映射中。
+# '<<'称为语言无关的合并键类型（Merge Key Language-Independent Type）.
+# 它表明一个或多个指定映射中的所有键值会插入到当前的映射中。
 
 foo: &foo
   <<: *base
@@ -137,22 +137,22 @@ bar: &bar
 
 # foo 和 bar 将都含有 name: Everyone has same name
 
-# YAML 还有标签，你可以用它显式地声明类型。
+# YAML 还有标签（tags），你可以用它显式地声明类型。
 explicit_string: !!str 0.5
-# 一些解析器实现特定语言的标签，就像这个针对 Python 的复数类型。
+# 一些解析器实现了特定语言的标签，就像这个针对Python的复数类型的标签。
 python_complex_number: !!python/complex 1+2j
 
-# 我们也可以在 YAML 的复合键中使用特定语言的标签
+# 我们也可以在 YAML 的复合键中使用特定语言的标签：
 ? !!python/tuple [5, 7]
 : Fifty Seven
-# 将会是 Python 中的  {(5, 7): 'Fifty Seven'}
+# 将会是 Python 中的 {(5, 7): 'Fifty Seven'}
 
 ####################
 # 其余的 YAML 类型 #
 ####################
 
-# 除了字符串和数字，YAML 还能理解其它标量。
-# ISO 格式的日期和日期时间文本也可以被解析。
+# 除了字符串和数字，YAML 还支持其它标量。
+# ISO 格式的日期和时间字面量也可以被解析。
 datetime: 2001-12-15T02:59:43.1Z
 datetime_with_spaces: 2001-12-14 21:59:43.10 -5
 date: 2002-12-14
@@ -165,14 +165,14 @@ gif_file: !!binary |
   +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
   AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
 
-# YAML 还有一个集合类型，它看起来像这样：
+# YAML 还有一个集合（set）类型，它看起来像这样：
 set:
   ? item1
   ? item2
   ? item3
 or: {item1, item2, item3}
 
-# 集合只是值为 null 的映射；上面的集合等价于：
+# 集合只是值均为 null 的映射；上面的集合等价于：
 set2:
   item1: null
   item2: null
@@ -184,4 +184,5 @@ set2:
 ### 更多资源
 
 + [YAML official website](http://yaml.org/)
++ [Online YAML Converter](http://yamlonline.com)
 + [Online YAML Validator](http://codebeautify.org/yaml-validator)