klion26 commented on a change in pull request #12230:
URL: https://github.com/apache/flink/pull/12230#discussion_r428406792
##########
File path: docs/getting-started/index.zh.md
##########
@@ -27,61 +27,27 @@ specific language governing permissions and limitations
under the License.
-->
-There are many ways to get started with Apache Flink. Which one is the best for
-you depends on your goals and prior experience:
+上手使用 Apache Flink 有很多方式，哪一个最适合你取决于你的目标和以前的经验。
-* take a look at the **Docker Playgrounds** if you want to see what Flink can
do, via a hands-on,
- docker-based introduction to specific Flink concepts
-* explore one of the **Code Walkthroughs** if you want a quick, end-to-end
- introduction to one of Flink's APIs
-* work your way through the **Hands-on Training** for a comprehensive,
- step-by-step introduction to Flink
-* use **Project Setup** if you already know the basics of Flink and want a
- project template for Java or Scala, or need help setting up the dependencies
+* 通过阅读 **Docker Playgrounds** 小节中基于 Docker 的 Flink 实践可以了解 Flink 的基本概念和功能。
+* 通过阅读 **Code Walkthroughs** 小节可以快速了解 Flink API。
+* 通过阅读 **Hands-on Training** 章节可以逐步全面学习 Flink。
+* 如果你已经了解 Flink 的基本概念并且想构建 Flink 项目，可以通过**项目构建设置**小节获取 Java/Scala 的项目模板或项目依赖。
-### Taking a first look at Flink
+### 初识 Flink
-The **Docker Playgrounds** provide sandboxed Flink environments that are set
up in just a few minutes and which allow you to explore and play with Flink.
+通过 **Docker Playgrounds** 提供的 Flink 沙盒环境，你只需花几分钟做些简单设置，就可以开始探索和使用 Flink。
-* The [**Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.md %}) shows you
how to operate streaming applications with Flink. You can experience how Flink
recovers application from failures, upgrade and scale streaming applications up
and down, and query application metrics.
+* [**Flink Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.zh.md %})
向你展示了如何使用 Flink 编写流数据应用程序。你可以从中学习到 Flink
应用程序的故障恢复、升级、并行度提高、并行度降低和程序运行状态的指标监控等特性。
Review comment:
`并行度提高、并行度降低` 如果改成 `修改并行度` 会好一些吗？
##########
File path: docs/getting-started/index.zh.md
##########
@@ -27,61 +27,27 @@ specific language governing permissions and limitations
under the License.
-->
-There are many ways to get started with Apache Flink. Which one is the best for
-you depends on your goals and prior experience:
+上手使用 Apache Flink 有很多方式，哪一个最适合你取决于你的目标和以前的经验。
-* take a look at the **Docker Playgrounds** if you want to see what Flink can
do, via a hands-on,
- docker-based introduction to specific Flink concepts
-* explore one of the **Code Walkthroughs** if you want a quick, end-to-end
- introduction to one of Flink's APIs
-* work your way through the **Hands-on Training** for a comprehensive,
- step-by-step introduction to Flink
-* use **Project Setup** if you already know the basics of Flink and want a
- project template for Java or Scala, or need help setting up the dependencies
+* 通过阅读 **Docker Playgrounds** 小节中基于 Docker 的 Flink 实践可以了解 Flink 的基本概念和功能。
+* 通过阅读 **Code Walkthroughs** 小节可以快速了解 Flink API。
+* 通过阅读 **Hands-on Training** 章节可以逐步全面学习 Flink。
+* 如果你已经了解 Flink 的基本概念并且想构建 Flink 项目，可以通过**项目构建设置**小节获取 Java/Scala 的项目模板或项目依赖。
-### Taking a first look at Flink
+### 初识 Flink
-The **Docker Playgrounds** provide sandboxed Flink environments that are set
up in just a few minutes and which allow you to explore and play with Flink.
+通过 **Docker Playgrounds** 提供的 Flink 沙盒环境，你只需花几分钟做些简单设置，就可以开始探索和使用 Flink。
-* The [**Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.md %}) shows you
how to operate streaming applications with Flink. You can experience how Flink
recovers application from failures, upgrade and scale streaming applications up
and down, and query application metrics.
+* [**Flink Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.zh.md %})
向你展示了如何使用 Flink 编写流数据应用程序。你可以从中学习到 Flink
应用程序的故障恢复、升级、并行度提高、并行度降低和程序运行状态的指标监控等特性。
-<!--
-* The [**Streaming SQL Playground**]() provides a Flink cluster with a SQL CLI
client, tables which are fed by streaming data sources, and instructions for
how to run continuous streaming SQL queries on these tables. This is the
perfect environment for your first steps with streaming SQL.
--->
-
-### First steps with one of Flink's APIs
-
-The **Code Walkthroughs** are a great way to get started quickly with a
step-by-step introduction to
-one of Flink's APIs. Each walkthrough provides instructions for bootstrapping
a small skeleton
-project, and then shows how to extend it to a simple application.
+### Flink API 入门
-* The [**DataStream API** code walkthrough]({% link
getting-started/walkthroughs/datastream_api.md %}) shows how
- to implement a simple DataStream application and how to extend it to be
stateful and use timers.
- The DataStream API is Flink's main abstraction for implementing stateful
streaming applications
- with sophisticated time semantics in Java or Scala.
+**代码练习**是快速入门的最佳方式，通过代码练习可以逐步深入地理解 Flink API。每个示例都演示了如何构建基础的 Flink
代码框架，并如何逐步将其扩展为简单的应用程序。
-* Flink's **Table API** is a relational API used for writing SQL-like queries
in Java, Scala, or
- Python, which are then automatically optimized, and can be executed on batch
or streaming data
- with identical syntax and semantics. The [Table API code walkthrough for
Java and Scala]({% link
- getting-started/walkthroughs/table_api.md %}) shows how to implement a
simple Table API query on a
- batch source and how to evolve it into a continuous query on a streaming
source. There's also a
- similar [code walkthrough for the Python Table API]({% link
- getting-started/walkthroughs/python_table_api.md %}).
+* [**DataStream API 示例**]({% link
getting-started/walkthroughs/datastream_api.zh.md %}) 展示了如何实现一个基本的 DataStream
应用程序，并把它扩展成有状态的应用程序。DataStream API 是 Flink 的主要抽象，可用于在 Java/Scala
语言中实现具有复杂时间语义的有状态数据流处理的应用程序。
Review comment:
`可用于在 Java/Scala 语言中` 是否可以改成 `可用于 Java/Scala 中` 呢
##########
File path: docs/getting-started/index.zh.md
##########
@@ -27,61 +27,27 @@ specific language governing permissions and limitations
under the License.
-->
-There are many ways to get started with Apache Flink. Which one is the best for
-you depends on your goals and prior experience:
+上手使用 Apache Flink 有很多方式，哪一个最适合你取决于你的目标和以前的经验。
-* take a look at the **Docker Playgrounds** if you want to see what Flink can
do, via a hands-on,
- docker-based introduction to specific Flink concepts
-* explore one of the **Code Walkthroughs** if you want a quick, end-to-end
- introduction to one of Flink's APIs
-* work your way through the **Hands-on Training** for a comprehensive,
- step-by-step introduction to Flink
-* use **Project Setup** if you already know the basics of Flink and want a
- project template for Java or Scala, or need help setting up the dependencies
+* 通过阅读 **Docker Playgrounds** 小节中基于 Docker 的 Flink 实践可以了解 Flink 的基本概念和功能。
+* 通过阅读 **Code Walkthroughs** 小节可以快速了解 Flink API。
+* 通过阅读 **Hands-on Training** 章节可以逐步全面学习 Flink。
+* 如果你已经了解 Flink 的基本概念并且想构建 Flink 项目，可以通过**项目构建设置**小节获取 Java/Scala 的项目模板或项目依赖。
-### Taking a first look at Flink
+### 初识 Flink
-The **Docker Playgrounds** provide sandboxed Flink environments that are set
up in just a few minutes and which allow you to explore and play with Flink.
+通过 **Docker Playgrounds** 提供的 Flink 沙盒环境，你只需花几分钟做些简单设置，就可以开始探索和使用 Flink。
-* The [**Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.md %}) shows you
how to operate streaming applications with Flink. You can experience how Flink
recovers application from failures, upgrade and scale streaming applications up
and down, and query application metrics.
+* [**Flink Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.zh.md %})
向你展示了如何使用 Flink 编写流数据应用程序。你可以从中学习到 Flink
应用程序的故障恢复、升级、并行度提高、并行度降低和程序运行状态的指标监控等特性。
-<!--
-* The [**Streaming SQL Playground**]() provides a Flink cluster with a SQL CLI
client, tables which are fed by streaming data sources, and instructions for
how to run continuous streaming SQL queries on these tables. This is the
perfect environment for your first steps with streaming SQL.
--->
-
-### First steps with one of Flink's APIs
-
-The **Code Walkthroughs** are a great way to get started quickly with a
step-by-step introduction to
-one of Flink's APIs. Each walkthrough provides instructions for bootstrapping
a small skeleton
-project, and then shows how to extend it to a simple application.
+### Flink API 入门
-* The [**DataStream API** code walkthrough]({% link
getting-started/walkthroughs/datastream_api.md %}) shows how
- to implement a simple DataStream application and how to extend it to be
stateful and use timers.
- The DataStream API is Flink's main abstraction for implementing stateful
streaming applications
- with sophisticated time semantics in Java or Scala.
+**代码练习**是快速入门的最佳方式，通过代码练习可以逐步深入地理解 Flink API。每个示例都演示了如何构建基础的 Flink
代码框架，并如何逐步将其扩展为简单的应用程序。
-* Flink's **Table API** is a relational API used for writing SQL-like queries
in Java, Scala, or
- Python, which are then automatically optimized, and can be executed on batch
or streaming data
- with identical syntax and semantics. The [Table API code walkthrough for
Java and Scala]({% link
- getting-started/walkthroughs/table_api.md %}) shows how to implement a
simple Table API query on a
- batch source and how to evolve it into a continuous query on a streaming
source. There's also a
- similar [code walkthrough for the Python Table API]({% link
- getting-started/walkthroughs/python_table_api.md %}).
+* [**DataStream API 示例**]({% link
getting-started/walkthroughs/datastream_api.zh.md %}) 展示了如何实现一个基本的 DataStream
应用程序，并把它扩展成有状态的应用程序。DataStream API 是 Flink 的主要抽象，可用于在 Java/Scala
语言中实现具有复杂时间语义的有状态数据流处理的应用程序。
-### Taking a Deep Dive with the Hands-on Training
-
-The [**Hands-on Training**]({% link training/index.md %}) is a self-paced
training course with
-a set of lessons and hands-on exercises. This step-by-step introduction to
Flink focuses
-on learning how to use the DataStream API to meet the needs of common,
real-world use cases,
-and provides a complete introduction to the fundamental concepts: parallel
dataflows,
-stateful stream processing, event time and watermarking, and fault tolerance
via state snapshots.
-
-<!--
-### Starting a new Flink application
+Flink 的 **Table API** 是一套可以用于在 Java/Scala/Python 中编写类 SQL 查询的声明式关系型 API，使用
Table API，系统不但可以自动进行计算和优化，而且可以使用一致的语法和语义在批处理场景或流处理场景中运行。[Table API code
walkthrough for Java and Scala]({% link
getting-started/walkthroughs/table_api.zh.md %}) 演示了如何在批处理中简单的使用 Table API
进行查询，以及如何将其扩展为流处理中的查询。Python Table API 同上 [code walkthrough for the Python
Table API]({% link getting-started/walkthroughs/python_table_api.zh.md %})。
Review comment:
你觉得 `Table API code walkthrough for Java and Scala` 这个需要翻译吗？
##########
File path: docs/getting-started/index.zh.md
##########
@@ -27,61 +27,27 @@ specific language governing permissions and limitations
under the License.
-->
-There are many ways to get started with Apache Flink. Which one is the best for
-you depends on your goals and prior experience:
+上手使用 Apache Flink 有很多方式，哪一个最适合你取决于你的目标和以前的经验。
-* take a look at the **Docker Playgrounds** if you want to see what Flink can
do, via a hands-on,
- docker-based introduction to specific Flink concepts
-* explore one of the **Code Walkthroughs** if you want a quick, end-to-end
- introduction to one of Flink's APIs
-* work your way through the **Hands-on Training** for a comprehensive,
- step-by-step introduction to Flink
-* use **Project Setup** if you already know the basics of Flink and want a
- project template for Java or Scala, or need help setting up the dependencies
+* 通过阅读 **Docker Playgrounds** 小节中基于 Docker 的 Flink 实践可以了解 Flink 的基本概念和功能。
+* 通过阅读 **Code Walkthroughs** 小节可以快速了解 Flink API。
+* 通过阅读 **Hands-on Training** 章节可以逐步全面学习 Flink。
+* 如果你已经了解 Flink 的基本概念并且想构建 Flink 项目，可以通过**项目构建设置**小节获取 Java/Scala 的项目模板或项目依赖。
-### Taking a first look at Flink
+### 初识 Flink
-The **Docker Playgrounds** provide sandboxed Flink environments that are set
up in just a few minutes and which allow you to explore and play with Flink.
+通过 **Docker Playgrounds** 提供的 Flink 沙盒环境，你只需花几分钟做些简单设置，就可以开始探索和使用 Flink。
-* The [**Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.md %}) shows you
how to operate streaming applications with Flink. You can experience how Flink
recovers application from failures, upgrade and scale streaming applications up
and down, and query application metrics.
+* [**Flink Operations Playground**]({% link
getting-started/docker-playgrounds/flink-operations-playground.zh.md %})
向你展示了如何使用 Flink 编写流数据应用程序。你可以从中学习到 Flink
应用程序的故障恢复、升级、并行度提高、并行度降低和程序运行状态的指标监控等特性。
-<!--
-* The [**Streaming SQL Playground**]() provides a Flink cluster with a SQL CLI
client, tables which are fed by streaming data sources, and instructions for
how to run continuous streaming SQL queries on these tables. This is the
perfect environment for your first steps with streaming SQL.
--->
-
-### First steps with one of Flink's APIs
-
-The **Code Walkthroughs** are a great way to get started quickly with a
step-by-step introduction to
-one of Flink's APIs. Each walkthrough provides instructions for bootstrapping
a small skeleton
-project, and then shows how to extend it to a simple application.
+### Flink API 入门
-* The [**DataStream API** code walkthrough]({% link
getting-started/walkthroughs/datastream_api.md %}) shows how
- to implement a simple DataStream application and how to extend it to be
stateful and use timers.
- The DataStream API is Flink's main abstraction for implementing stateful
streaming applications
- with sophisticated time semantics in Java or Scala.
+**代码练习**是快速入门的最佳方式，通过代码练习可以逐步深入地理解 Flink API。每个示例都演示了如何构建基础的 Flink
代码框架，并如何逐步将其扩展为简单的应用程序。
-* Flink's **Table API** is a relational API used for writing SQL-like queries
in Java, Scala, or
- Python, which are then automatically optimized, and can be executed on batch
or streaming data
- with identical syntax and semantics. The [Table API code walkthrough for
Java and Scala]({% link
- getting-started/walkthroughs/table_api.md %}) shows how to implement a
simple Table API query on a
- batch source and how to evolve it into a continuous query on a streaming
source. There's also a
- similar [code walkthrough for the Python Table API]({% link
- getting-started/walkthroughs/python_table_api.md %}).
+* [**DataStream API 示例**]({% link
getting-started/walkthroughs/datastream_api.zh.md %}) 展示了如何实现一个基本的 DataStream
应用程序，并把它扩展成有状态的应用程序。DataStream API 是 Flink 的主要抽象，可用于在 Java/Scala
语言中实现具有复杂时间语义的有状态数据流处理的应用程序。
Review comment:
```suggestion
* [**DataStream API 示例**]({% link
getting-started/walkthroughs/datastream_api.zh.md %})展示了如何实现一个基本的 DataStream
应用程序，并把它扩展成有状态的应用程序。DataStream API 是 Flink 的主要抽象，可用于在 Java/Scala
语言中实现具有复杂时间语义的有状态数据流处理的应用程序。
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
