modify/correct _zh-cn/index.md

_zh-cn/index.md

@@ -12,37 +12,37 @@ scala3-sections:
 - title: "第一步"
   links:
     - title: "Scala 3 中的新东西"
-      description: "Scala 3 现存新特性概览"
+      description: "Scala 3 中令人兴奋的新特性概览"
       icon: "fa fa-star"
       link: /scala3/new-in-scala3.html
     - title: "快速开始"
-      description: "安装 Scala 3 并开始写些 Scala 代码"
+      description: "在你的电脑中安装 Scala 3，然后开始写些 Scala 代码！"
       icon: "fa fa-rocket"
       link: /scala3/getting-started.html
-    - title: "Scala 3 书籍"
-      description: "一部介绍主要语言特性的线上书"
+    - title: "Scala 3 册子"
+      description: "通过一系列小课程来学习 Scala。"
       icon: "fa fa-book"
       link: /scala3/book/introduction.html
 - title: "更多细节"
   links:
     - title: "迁移指引"
-      description: "一份帮你从 Scala 2 迁移到 Scala 3 的指引"
+      description: "一份帮你从 Scala 2 迁移到 Scala 3 的指引。"
       icon: "fa fa-suitcase"
       link: /scala3/guides/migration/compatibility-intro.html
     - title: "导览"
-      description: "关于语言特别之处的详细导览"
+      description: "关于语言特别之处的详细导览。"
       icon: "fa fa-map"
       link: /zh-cn/scala3/guides.html
     - title: "Scala 库 API"
-      description: "Scala 3 标准库API文档（多个小版本）"
+      description: "Scala 3 每一个版本的标准库API文档。"
       icon: "fa fa-file-alt"
       link: https://scala-lang.org/api/3.x/
     - title: "语言参考手册"
-      description: "Scala 3 语言参考手册"
+      description: "Scala 3 语言参考手册。"
       icon: "fa fa-book"
       link: https://docs.scala-lang.org/scala3/reference
     - title: "贡献指南"
-      description: "Scala 3 编译器指南及如何贡献代码"
+      description: "Scala 3 编译器指南及如何修复问题"
       icon: "fa fa-cogs"
       link: /scala3/guides/contribution/contribution-intro.html
     - title: "Scala 3 全新的 Scaladoc"
@@ -109,4 +109,8 @@ scala2-sections:
         description: "Scala改进过程（Scala Improvement Process），语言及编译器进展"
         icon: "fa fa-cogs"
         link: /sips/index.html
+      - title: "为 Scala 作贡献"
+        description: "为 Scala 项目作贡献的完整指南"
+        icon: "fa fa-cogs"
+        link: /contribute/
 ---

_zh-cn/overviews/scala3-book/taste-control-structures.md

@@ -0,0 +1,270 @@
+---
+title: 控制结构
+type: section
+description: This section demonstrates Scala 3 control structures.
+num: 8
+previous-page: taste-vars-data-types
+next-page: taste-modeling
+---
+
+
+Scala 具有您在其他编程语言中可以找到的控制结构，并且还具有强大的 `for` 表达式和 `match` 表达式：
+
+- `if`/`else`
+- `for` 循环和表达式
+- `match` 表达式
+- `while` 循环
+- `try`/`catch`
+
+这些结构在以下示例中进行了说明。
+
+## `if`/`else`
+
+Scala 的 `if`/`else` 控制结构看起来与其他语言相似：
+
+```scala
+if x < 0 then
+  println("negative")
+else if x == 0 then
+  println("zero")
+else
+  println("positive")
+```
+
+请注意，这确实是一个 _表达式_ ---不是一个 _语句_。
+这意味着它返回一个值，因此您可以将结果赋值给一个变量：
+
+```scala
+val x = if a < b then a else b
+```
+
+正如您将在本书中看到的那样，_所有_ Scala 控制结构都可以用作表达式。
+
+> 表达式返回结果，而语句不返回。
+> 语句通常用于它们的副作用，例如使用 `println` 打印到控制台。
+
+在 Scala 2 中 `if`/`else` 控制结构的构造不同，需要括号和大括号，而不是关键字 `then`。
+
+```scala
+// Scala 2 syntax
+if (test1) {
+    doX()
+} else if (test2) {
+    doY()
+} else {
+    doZ()
+}
+```
+
+## `for` 循环和表达式
+
+`for` 关键字用于创建 `for` 循环。
+这个例子展示了如何打印 `List` 中的每个元素：
+
+```scala
+val ints = List(1, 2, 3, 4, 5)
+
+for i <- ints do println(i)
+```
+
+代码 `i <- ints` 被称为 _生成器_，紧随 `do` 关键字的代码是 _循环体_。
+
+Scala 2 中这种控制结构的旧语法是：
+
+```scala
+// Scala 2 语法
+for (i <- ints) println(i)
+```
+
+再次注意括号的使用和 Scala 3 中新的 `for`-`do`。
+
+### 守卫
+
+您还可以在 `for` 循环中使用一个或多个 `if` 表达式。
+这些被称为 _守卫_。
+此示例打印 `ints` 中大于 `2` 的所有数字：
+
+```scala
+for
+  i <- ints
+  if i > 2
+do
+  println(i)
+```
+
+您可以使用多个生成器和守卫。
+此循环遍历数字 `1` 到 `3`，并且对于每个数字，它还遍历字符 `a` 到 `c`。
+然而，它也有两个守卫，所以唯一一次调用 print 语句是当 `i` 的值为 `2` 并且 `j` 是字符 `b` 时：
+
+```scala
+for
+  i <- 1 to 3
+  j <- 'a' to 'c'
+  if i == 2
+  if j == 'b'
+do
+  println(s"i = $i, j = $j")   // prints: "i = 2, j = b"
+```
+
+### `for` 表达式
+
+`for` 关键字更强大：当您使用 `yield` 关键字代替 `do` 时，您会创建 `for` _表达式_ 用于计算和产生结果。
+
+几个例子演示了这一点。
+使用与上一个示例相同的 `ints` 列表，此代码创建一个新列表，其中新列表中每个元素的值是原始列表中元素值的两倍：
+
+````
+scala> val doubles = for i <- ints yield i * 2
+val doubles: List[Int] = List(2, 4, 6, 8, 10)
+````
+
+Scala 的控制结构语法很灵活，`for` 表达式可以用其他几种方式编写，具体取决于您的偏好：
+
+```scala
+val doubles = for i <- ints yield i * 2     // 如上所示的风格
+val doubles = for (i <- ints) yield i * 2
+val doubles = for (i <- ints) yield (i * 2)
+val doubles = for { i <- ints } yield (i * 2)
+```
+
+此示例显示如何将列表中每个字符串的第一个字符大写：
+
+```scala
+val names = List("chris", "ed", "maurice")
+val capNames = for name <- names yield name.capitalize
+```
+
+最后，这个 `for` 表达式遍历一个字符串列表，并返回每个字符串的长度，但前提是该长度大于 `4`：
+
+```scala
+val fruits = List("apple", "banana", "lime", "orange")
+
+val fruitLengths = for
+  f <- fruits
+  if f.length > 4
+yield
+  // 在这里你可以
+  // 使用多行代码
+  f.length
+
+//fruitLengths: List[Int] = List(5, 6, 6)
+```
+
+`for` 循环和表达式更多细节在本书的 [控制结构部分][control] 中，和 [参考文档]({{ site.scala3ref }}/other-new-features/control-syntax.html) 中。
+
+## `match` 表达式
+
+Scala 有一个 `match` 表达式，它最基本的用途类似于 Java `switch` 语句：
+
+```scala
+val i = 1
+
+// later in the code ...
+i match
+  case 1 => println("one")
+  case 2 => println("two")
+  case _ => println("other")
+```
+
+但是，`match` 确实是一个表达式，这意味着它会根据模式匹配返回一个结果，您可以将其绑定到一个变量：
+
+```scala
+val result = i match
+  case 1 => "one"
+  case 2 => "two"
+  case _ => "other"
+```
+
+`match` 不仅限于使用整数值，它可以用于任何数据类型：
+
+```scala
+val p = Person("Fred")
+
+// later in the code
+p match
+  case Person(name) if name == "Fred" =>
+    println(s"$name says, Yubba dubba doo")
+
+  case Person(name) if name == "Bam Bam" =>
+    println(s"$name says, Bam bam!")
+
+  case _ => println("Watch the Flintstones!")
+```
+
+事实上，`match` 表达式可以用许多模式的不同类型来测试变量。
+此示例显示 (a) 如何使用 `match` 表达式作为方法的主体，以及 (b) 如何匹配显示的所有不同类型：
+
+```scala
+// getClassAsString 是一个接受任何类型的单个参数的方法。
+def getClassAsString(x: Matchable): String = x match
+  case s: String => s"'$s' is a String"
+  case i: Int => "Int"
+  case d: Double => "Double"
+  case l: List[_] => "List"
+  case _ => "Unknown"
+
+// examples
+getClassAsString(1)               // Int
+getClassAsString("hello")         // 'hello' is a String
+getClassAsString(List(1, 2, 3))   // List
+```
+
+`getClassAsString` 方法将 [Matchable]({{ site.scala3ref }}/other-new-features/matchable.html) 类型的值作为参数，它可以是
+任何支持模式匹配的类型（某些类型不支持模式匹配，因为这可能
+打破封装）。
+
+Scala 中的模式匹配还有 _更多_ 内容。
+模式可以嵌套，模式的结果可以绑定，模式匹配甚至可以是用户自定义的。
+有关详细信息，请参阅 [控制结构章节][control] 中的模式匹配示例。
+
+## `try`/`catch`/`finally`
+
+Scala 的 `try`/`catch`/`finally` 控制结构让你捕获异常。
+它类似于 Java，但其语法与 `match` 表达式一致：
+
+```scala
+try
+  writeTextToFile(text)
+catch
+  case ioe: IOException => println("Got an IOException.")
+  case nfe: NumberFormatException => println("Got a NumberFormatException.")
+finally
+  println("Clean up your resources here.")
+```
+
+## `while` 循环
+
+Scala 还有一个 `while` 循环结构。
+它的单行语法如下所示：
+
+```scala
+while x >= 0 do x = f(x)
+```
+
+在 Scala 2 中，语法有点不同。条件用括号括起来，并且
+没有 `do` 关键字：
+
+```scala
+while (x >= 0) { x = f(x) }
+```
+
+为了兼容性，Scala 3 仍然支持 Scala 2 语法。
+
+`while` 循环多行语法如下所示：
+
+```scala
+var x = 1
+
+while
+  x < 3
+do
+  println(x)
+  x += 1
+```
+
+## 自定义控制结构
+
+由于 by-name 参数、中缀表示法、流畅接口、可选括号、扩展方法和高阶函数等功能，您还可以创建自己的代码，就像控制结构一样工作。
+您将在 [控制结构][control] 部分了解更多信息。
+
+[control]: {% link _overviews/scala3-book/control-structures.md %}

_zh-cn/overviews/scala3-book/taste-functions.md

@@ -0,0 +1,62 @@
+---
+title: First-Class Functions
+type: section
+description: This page provides an introduction to functions in Scala 3.
+num: 11
+previous-page: taste-methods
+next-page: taste-objects
+---
+
+
+Scala具有函数式编程语言中您期望的大多数功能，包括：
+
+- Lambdas（匿名函数）
+- 高阶函数 （HOFs）
+- 标准库中的不可变集合
+
+Lambdas（也称为 _匿名函数_）是保持代码简洁但可读性的重要组成部分。
+
+`List` 类的 `map` 方法是高阶函数的典型示例---一个将函数作为参数的函数。
+
+这两个示例是等效的，并演示如何通过将 lambda 传递到 `map` 方法中，将列表中的每个数字乘以 `2`：
+
+```scala
+val a = List(1, 2, 3).map(i => i * 2)   // List(2,4,6)
+val b = List(1, 2, 3).map(_ * 2)        // List(2,4,6)
+```
+
+这些示例也等效于以下代码，该代码使用 `double` 方法而不是lambda：
+
+```scala
+def double(i: Int): Int = i * 2
+
+val a = List(1, 2, 3).map(i => double(i))   // List(2,4,6)
+val b = List(1, 2, 3).map(double)           // List(2,4,6)
+```
+
+> 如果您以前从未见过 `map` 方法，它会将给定的函数应用于列表中的每个元素，从而生成一个包含结果值的新列表。
+
+将 lambda 传递给集合类上的高阶函数（如 `List`）是 Scala 体验的一部分，您每天都会这样做。
+
+## 不可变集合
+
+当您使用不可变集合（如 `List`，`Vector`）以及不可变的 `Map` 和 `Set` 类时，重要的是要知道这些函数不会改变它们被调用的集合；相反，它们返回包含更新数据的新集合。
+因此，以“流式”的风格将它们链接在一起以解决问题也很常见。
+
+例如，此示例演示如何对一个集合进行两次筛选，然后将其余集合中的每个元素乘某个数：
+
+```scala
+// a sample list
+val nums = (1 to 10).toList   // List(1,2,3,4,5,6,7,8,9,10)
+
+// methods can be chained together as needed
+val x = nums.filter(_ > 3)
+            .filter(_ < 7)
+            .map(_ * 10)
+
+// result: x == List(40, 50, 60)
+```
+
+除了在整个标准库中使用的高阶函数外，您还可以[创建自己的][higher-order] 高阶函数。
+
+[higher-order]: {% link _overviews/scala3-book/fun-hofs.md %}