翻译《协程指南》

Author: hltj

docs/coroutines-guide.md

@@ -1,32 +1,32 @@
 
-Kotlin, as a language, provides only minimal low-level APIs in its standard library to enable various other 
-libraries to utilize coroutines. Unlike many other languages with similar capabilities, `async` and `await`
-are not keywords in Kotlin and are not even part of its standard library. Moreover, Kotlin's concept
-of _suspending function_ provides a safer and less error-prone abstraction for asynchronous 
-operations than futures and promises.  
+Kotlin 是一门只提供最基本底层 API 以便各种其他<!--
+-->库能够利用协程的语言。与许多其他具有类似功能的语言不同，`async` 与 `await`
+在 Kotlin 中并不是关键字，甚至都不是标准库的一部分。此外，Kotlin 的
+_挂起函数_ 概念为异步操作提供了比
+future 与 promise 更安全、不易出错的抽象。
 
-`kotlinx.coroutines` is a rich library for coroutines developed by JetBrains. It contains a number of high-level 
-coroutine-enabled primitives that this guide covers, including `launch`, `async` and others. 
+`kotlinx.coroutines` 是由 JetBrains 开发的丰富的协程库。它包含<!--
+-->本指南中涵盖的很多启用高级协程的原语，包括 `launch`、 `async` 等等。
 
-This is a guide on core features of `kotlinx.coroutines` with a series of examples, divided up into different topics.
+本文是关于 `kotlinx.coroutines` 核心特性的指南，包含一系列示例，分为不同的主题。
 
-In order to use coroutines as well as follow the examples in this guide, you need to add a dependency on `kotlinx-coroutines-core` module as explained 
-[in the project README ](../README.md#using-in-your-projects).
+为了使用协程以及按照本指南中的示例演练，需要添加对 `kotlinx-coroutines-core` 模块的依赖，如<!--
+-->[项目中的 README 文件](../README.md#using-in-your-projects)所述。
 
-## Table of contents
+## 目录
 
-* [Coroutine basics](basics.md)
-* [Cancellation and timeouts](cancellation-and-timeouts.md)
-* [Composing suspending functions](composing-suspending-functions.md)
-* [Coroutine context and dispatchers](coroutine-context-and-dispatchers.md)
-* [Exception handling and supervision](exception-handling.md)
-* [Channels (experimental)](channels.md)
-* [Shared mutable state and concurrency](shared-mutable-state-and-concurrency.md)
-* [Select expression (experimental)](select-expression.md)
+* [协程基础](basics.md)
+* [取消与超时](cancellation-and-timeouts.md)
+* [组合挂起函数](composing-suspending-functions.md)
+* [协程上下文与调度器](coroutine-context-and-dispatchers.md)
+* [异常处理与监管](exception-handling.md)
+* [通道（实验性的）](channels.md)
+* [共享的可变状态与并发](shared-mutable-state-and-concurrency.md)
+* [Select 表达式（实验性的）](select-expression.md)
 
-## Additional references
+## 其他参考资料
 
-* [Guide to UI programming with coroutines](../ui/coroutines-guide-ui.md)
-* [Guide to reactive streams with coroutines](../reactive/coroutines-guide-reactive.md)
-* [Coroutines design document (KEEP)](https://github.com/Kotlin/kotlin-coroutines/blob/master/kotlin-coroutines-informal.md)
-* [Full kotlinx.coroutines API reference](http://kotlin.github.io/kotlinx.coroutines)
+* [使用协程进行 UI 编程指南](../ui/coroutines-guide-ui.md)
+* [响应式流与协程指南](../reactive/coroutines-guide-reactive.md)
+* [协程设计文档（KEEP）](https://github.com/Kotlin/kotlin-coroutines/blob/master/kotlin-coroutines-informal.md)
+* [完整的 kotlinx.coroutines API 参考文档](http://kotlin.github.io/kotlinx.coroutines)