update the Chinese vesion #73

kun-song · 2018-06-09T13:56:51Z

It's been more than one year since the last updates of the Chinese version, now I make the following changes:

add the missing error handing and exception handing chapters
fix several errors in translation
polish almost all original translations
use Chinese punctuation instead of English punctuation
add space before and after the English word

CLAassistant · 2018-06-09T13:56:57Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

yufangong

Hey, thank you so much for doing this! This is awesome! I'm halfway through this PR and left some comments here. I'll finish reading soon.

yufangong · 2018-06-12T18:25:04Z

effectivescala-cn.mo

-这是一篇“活的”文档，我们会更新它,以反映我们当前的最佳实践，但核心的思想不太可能会变： 永远重视可读性；写泛化的代码但不要牺牲清晰度；
-利用简单的语言特性的威力，但避免晦涩难懂（尤其是类型系统）。最重要的，总要意识到你所做的取舍。一门成熟的(sophisticated)语言需要复杂的实现，复杂性又产生了复杂性：之于推理，之于语义，之于特性之间的交互，以及与你合作者之间的理解。因此复杂性是为成熟所交的税——你必须确保效用超过它的成本。
+这是一篇“活的”文档，我们会更新它,以反映我们当前的最佳实践，但核心的思想不太可能会变：永远重视可读性；在不损失清晰度的前提下，编写通用的代码（generic code）；
+使用简单却威力强大的语言特性，但避免使用晦涩难懂（尤其是类型系统）的特性。最重要的是对自己所做的取舍心中有数。精巧的语言需要复杂的实现，复杂性又产生了复杂性：之于推理，之于语义，之于特性之间的交互，以及与你合作者之间的理解。因此复杂性是为精巧的代价——你必须确保它带来的好处高于它的成本。


s/但避免使用晦涩难懂（尤其是类型系统）的特性/但避免使其晦涩难懂（尤其是类型系统

yufangong · 2018-06-12T18:30:20Z

effectivescala-cn.mo


 ### 命名

 <dl class="rules">
 <dt>对作用域较短的变量使用短名字：</dt>
 <dd> <code>i</code>s, <code>j</code>s 和 <code>k</code>s等可出现在循环中。</dd>
 <dt>对作用域较长的变量使用长名字：</dt>
-<dd>外部APIs应该用长的，不需加以说明便可理解的名字。例如：<code>Future.collect</code> 而非 <code>Future.all</code>
+<dd>外部 APIs 应该用长的，不需加以说明便可理解的名字。例如：<code>Future.collect</code> 而非 <code>Future.all</code>


较长的？

yufangong · 2018-06-12T18:32:26Z

effectivescala-cn.mo

@@ -132,63 +132,63 @@ import concurrent</code></pre> 而应该用清晰的：<pre><code>import com.twi
       case None => default
     }

-.LP 它很清晰的表达了 list中的元素都被映射，间接的方式让人不容易明白。
+.LP 它很清晰的表达了list中的元素都被映射处理，间接的方式让人不容易明白。


（space)list(space) for consistence.

yufangong · 2018-06-12T18:47:15Z

effectivescala-cn.mo


-Scala的强大类型系统是学术探索和实践共同来源(例如[Type level programming in Scala](http://apocalisp.wordpress.com/2010/06/08/type-level-programming-in-scala/)) 。但这是一个迷人的学术话题，这些技术很少在应用和正式产品代码中使用。它们应该被避免。
+Scala 强大的类型系统是学术探索和实践共同来源（例如[Type level programming in Scala](http://apocalisp.wordpress.com/2010/06/08/type-level-programming-in-scala/)） 。虽然这是一个迷人的学术话题，但这些技术很少用于生产代码。应该避免使用它们。


我认为 production code 在这里指产品代码，
“但这些技术很少应用于产品代码“ 如何？

yufangong · 2018-06-12T18:56:52Z

effectivescala-cn.mo


-尽管Scala允许返回类型是可以省略的，加上它们提供了很好的文档：这对public方法特别重要。而当一个方法不需要对外暴露，并且它的返回值类型是显而易见的时候，则可以直接省略。
+尽管 Scala 允许省略返回类型，但它们提供了很好的文档：这对 public 方法尤其重要。当方法不对外暴露，且其返回值类型显而易见时，可直接省略返回值类型。


让我们指代更明确一些：但这些返回类型提供了很好的文档

yufangong · 2018-06-12T19:00:03Z

effectivescala-cn.mo


     trait Service
     def make() = new Service {
       def getId = 123
     }

-.LP 上面的make<em>不需要</em>定义返回类型为Service；编译器会创建一个加工过的类型: Object with Service{def getId:Int}(译注:with是Scala里的mixin的语法)。若用一个显式的注释：
+.LP make 的返回类型<em>根本不是</em><code>Service</code>；编译器会为其创建一个加工过的类型：<code>Object with Service{def getId:Int}</code>。此时需要显式地添加返回类型：


s/根本不是/没有标明是

yufangong · 2018-06-12T20:45:26Z

effectivescala-cn.mo


     val mammals: HashSet[Mammal] = dogs
     mammals.add(new Cat{})

-.LP 这将不再是一个只存储狗(dog)的HashSet！
+.LP 这将不再是一个 HashSet[Dog]！（译者注：在HashSet[Dog]中出现了Cat，失去了类型安全）


什么是类型安全？

yufangong · 2018-06-15T00:35:51Z

effectivescala-cn.mo


 一个健壮系统必须考虑超时和取消，两者都需要引入更多“控制”线程，使问题更加复杂。注意若线程很廉价这些问题也将会被削弱：不再需要一个线程池，超时的线程将被丢弃，不再需要额外的资源管理。

 因此，资源管理危害了模块化。

 ### Future

-使用Future管理并发。它们将并发操作从资源管理里解耦出来：例如，Finagle（译注：twitter的一个RFC框架）以有效的方式在少量线程上实现并发操作的复用。Scala有一个轻量级的闭包字面语法(literal syntax)，所以Futures引入了很少的语法开销，它们成为很多程序员的第二本能。
+使用 Future 管理并发。它们将并发操作从资源管理里解耦出来：例如，Finagle（译注：twitter 的一个 RFC 框架）以有效的方式在少量线程上实现并发操作的复用。Scala 有一个轻量级的闭包字面语法，所以 Futures 引入了很少的语法开销，它们成为很多程序员的第二本能。


Can you add the link here? [Finagle](https://github.com/twitter/finagle)
And I think it intended to say RPC 框架 here.

yufangong · 2018-06-15T00:43:52Z

effectivescala-cn.mo

-*Future组合子(combinators)的使用*。当操作多个futures时，Future.select，Future.join和Future.collect应该被组合编写出通用模式。
+*使用 Future 组合子（combinators）*。当组合多个 futures 时，Future.select、Future.join 和 Future.collect 内置了许多常见模式。
+
+*不要在返回 Future 的方法中抛出自定义的异常*。Future 可同时表示成功或失败的计算，因此最好将计算中出现的错误封装在返回的 Future 中，具体而言，返回 Future.exception 而非将直接抛出异常：


Thank you for adding this part.

yufangong · 2018-06-15T00:47:42Z

effectivescala-cn.mo


-如果一个不可变(immutable)集合可行，就尽可能用不可变集合——它们是指称透明的(referentially transparent)，所以在并发上下文推断它们是简单的。不可变集合的改变通常用更新引用到当前值(一个var单元或一个AtomicReference)。必须小心正确地应用：原子型的(atomics)必须重试(retried)，变量(var类型的)必须声明为volatile以保证它们发布(published)到它们的线程。
+如果可以用不可变（immutable）集合，就尽量用它——它们是引用透明的（referentially transparent），所以更容易在并发上下文中推断它们。不可变集合中的修改通常通过更新引用到当前值（一个var单元或一个AtomicReference）实现。必须小心正确地应用：原子型的（atomics）必须重试（retried），变量（var类型的）必须声明为 volatile 以防止它们发布（published）到其他线程。


s/引用到当前值/当前值的引用？

refresh the Chinese vesion

584cedf

add myself as the translator

4ea55b4

yufangong reviewed Jun 12, 2018

View reviewed changes

yufangong reviewed Jun 15, 2018

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

update the Chinese vesion #73

update the Chinese vesion #73

kun-song commented Jun 9, 2018 •

edited

Loading

CLAassistant commented Jun 9, 2018 •

edited

Loading

yufangong left a comment

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 12, 2018

yufangong Jun 15, 2018

yufangong Jun 15, 2018

yufangong Jun 15, 2018


		Scala的强大类型系统是学术探索和实践共同来源(例如[Type level programming in Scala](http://apocalisp.wordpress.com/2010/06/08/type-level-programming-in-scala/)) 。但这是一个迷人的学术话题，这些技术很少在应用和正式产品代码中使用。它们应该被避免。
		Scala 强大的类型系统是学术探索和实践共同来源（例如[Type level programming in Scala](http://apocalisp.wordpress.com/2010/06/08/type-level-programming-in-scala/)）。虽然这是一个迷人的学术话题，但这些技术很少用于生产代码。应该避免使用它们。


		尽管Scala允许返回类型是可以省略的，加上它们提供了很好的文档：这对public方法特别重要。而当一个方法不需要对外暴露，并且它的返回值类型是显而易见的时候，则可以直接省略。
		尽管 Scala 允许省略返回类型，但它们提供了很好的文档：这对 public 方法尤其重要。当方法不对外暴露，且其返回值类型显而易见时，可直接省略返回值类型。


		如果一个不可变(immutable)集合可行，就尽可能用不可变集合——它们是指称透明的(referentially transparent)，所以在并发上下文推断它们是简单的。不可变集合的改变通常用更新引用到当前值(一个var单元或一个AtomicReference)。必须小心正确地应用：原子型的(atomics)必须重试(retried)，变量(var类型的)必须声明为volatile以保证它们发布(published)到它们的线程。
		如果可以用不可变（immutable）集合，就尽量用它——它们是引用透明的（referentially transparent），所以更容易在并发上下文中推断它们。不可变集合中的修改通常通过更新引用到当前值（一个var单元或一个AtomicReference）实现。必须小心正确地应用：原子型的（atomics）必须重试（retried），变量（var类型的）必须声明为 volatile 以防止它们发布（published）到其他线程。

update the Chinese vesion #73

Are you sure you want to change the base?

update the Chinese vesion #73

Conversation

kun-song commented Jun 9, 2018 • edited Loading

CLAassistant commented Jun 9, 2018 • edited Loading

yufangong left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

kun-song commented Jun 9, 2018 •

edited

Loading

CLAassistant commented Jun 9, 2018 •

edited

Loading