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-collections.md

@@ -0,0 +1,108 @@
+---
+title: Collections
+type: section
+description: This page provides a high-level overview of the main features of the Scala 3 programming language.
+num: 13
+previous-page: taste-objects
+next-page: taste-contextual-abstractions
+---
+
+
+Scala 库具有一组丰富的集合类，这些类具有一组丰富的方法。
+集合类有不可变和可变两种形式。
+
+## 创建列表
+
+为了让您了解这些类的工作原理，下面是一些使用 `List` 类的示例，该类是不可变的链接列表类。
+这些示例显示了创建填充的 `List` 的不同方法：
+
+```scala
+val a = List(1, 2, 3)           // a: List[Int] = List(1, 2, 3)
+
+// Range methods
+val b = (1 to 5).toList         // b: List[Int] = List(1, 2, 3, 4, 5)
+val c = (1 to 10 by 2).toList   // c: List[Int] = List(1, 3, 5, 7, 9)
+val e = (1 until 5).toList      // e: List[Int] = List(1, 2, 3, 4)
+val f = List.range(1, 5)        // f: List[Int] = List(1, 2, 3, 4)
+val g = List.range(1, 10, 3)    // g: List[Int] = List(1, 4, 7)
+```
+
+## `List`方法
+
+拥有填充的列表后，以下示例将显示可以对其调用的一些方法。
+请注意，这些都是函数式方法，这意味着它们不会改变调用的集合，而是返回包含更新元素的新集合。
+每个表达式返回的结果显示在每行的注释中：
+
+```scala
+// a sample list
+val a = List(10, 20, 30, 40, 10)      // List(10, 20, 30, 40, 10)
+
+a.drop(2)                             // List(30, 40, 10)
+a.dropWhile(_ < 25)                   // List(30, 40, 10)
+a.filter(_ < 25)                      // List(10, 20, 10)
+a.slice(2,4)                          // List(30, 40)
+a.tail                                // List(20, 30, 40, 10)
+a.take(3)                             // List(10, 20, 30)
+a.takeWhile(_ < 30)                   // List(10, 20)
+
+// flatten
+val a = List(List(1,2), List(3,4))
+a.flatten                             // List(1, 2, 3, 4)
+
+// map, flatMap
+val nums = List("one", "two")
+nums.map(_.toUpperCase)               // List("ONE", "TWO")
+nums.flatMap(_.toUpperCase)           // List('O', 'N', 'E', 'T', 'W', 'O')
+```
+
+这些示例显示了如何使用 `foldLeft` 和 `reduceLeft` 方法来对整数序列中的值求和：
+
+```scala
+val firstTen = (1 to 10).toList            // List(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
+
+firstTen.reduceLeft(_ + _)                 // 55
+firstTen.foldLeft(100)(_ + _)              // 155 (100 is a “seed” value)
+```
+
+Scala 集合类还有更多可用的方法，它们在[集合章节][collections]和 [API 文档][api]中进行了演示。
+
+## 元组
+
+Scala _元组_ 是一种类型，可让您轻松地将不同类型的集合放在同一个容器中。
+例如，给定以下 `Person` 样例类：
+
+```scala
+case class Person(name: String)
+```
+
+这是演示你如创建一个元组，这个元组包含 `Int`, `String`, 和定制的 `Person` 值：
+
+```scala
+val t = (11, "eleven", Person("Eleven"))
+```
+
+有元组后，可以通过将其值绑定到变量来访问，也可以通过数字访问它们：
+
+```scala
+t(0)   // 11
+t(1)   // "eleven"
+t(2)   // Person("Eleven")
+```
+
+您还可以使用以下 _解析器_ 的办法将元组字段分配变量名：
+
+```scala
+val (num, str, person) = t
+
+// result:
+// val num: Int = 11
+// val str: String = eleven
+// val person: Person = Person(Eleven)
+```
+
+有些情况更适合使用元组， 那就是当你想要将异构类型的集合放在一个小的类似集合的结构中。
+有关更多元组详细信息，请参阅 [参考文档][reference]。
+
+[collections]: {% link _overviews/scala3-book/collections-intro.md %}
+[api]: https://scala-lang.org/api/3.x/
+[reference]: {{ site.scala3ref }}/overview.html

_zh-cn/overviews/scala3-book/taste-contextual-abstractions.md

@@ -0,0 +1,54 @@
+---
+title: Contextual Abstractions
+type: section
+description: This section provides an introduction to Contextual Abstractions in Scala 3.
+num: 14
+previous-page: taste-collections
+next-page: taste-toplevel-definitions
+---
+
+
+{% comment %}
+TODO: Now that this is a separate section, it needs a little more content.
+{% endcomment %}
+
+在某些情况下，可以省略在方法调用中你认为是重复的的某些参数。
+
+这些参数之所以称为 _上下文参数_，是因为它们是由编译器从方法调用周围的上下文中推断出来的。
+
+例如，考虑一个程序，该程序按两个条件对地址列表进行排序：城市名称，然后是街道名称。
+
+```scala
+val addresses: List[Address] = ...
+
+addresses.sortBy(address => (address.city, address.street))
+```
+
+`sortBy` 方法调用一个函数，该函数为每个地址返回值，这个值会用来与其他地址比较。
+在本例中，我们传递一个函数，该函数返回一对，该对包含城市名称和街道名称。
+
+请注意，我们只指示 _怎么_ 比较的，而不是 _如何_ 来执行比较。
+排序算法如何知道如何比较 `String` 对的？
+
+实际上，`sortBy` 方法采用第二个参数---一个上下文参数---该参数由编译器推断。
+它不会出现在上面的示例中，因为它是由编译器提供的。
+
+第二个参数实现 _如何_ 进行比较。
+省略它很方便，因为我们知道 `String` 通常使用词典顺序进行比较。
+
+但是，也可以显式传递它：
+
+```scala
+addresses.sortBy(address => (address.city, address.street))(using Ordering.Tuple2(Ordering.String, Ordering.String))
+```
+
+在本例中，`Ordering.Tuple2(Ordering.String, Ordering.String)`  实例正是编译器以其他方式推断的实例。
+换句话说，这两个示例生成相同的程序。
+
+_上下文抽象_ 用于避免重复代码。
+它们帮助开发人员编写可扩展且同时简洁的代码段。
+
+有关更多详细信息，请参阅本书的[上下文抽象章节][contextual]，以及[参考文档][reference]。
+
+[contextual]: {% link _overviews/scala3-book/ca-contextual-abstractions-intro.md %}
+[reference]: {{ site.scala3ref }}/overview.html