TisonKun commented on a change in pull request #9299: [FLINK-13405][docs-zh] Translate "Basic API Concepts" page into Chinese URL: https://github.com/apache/flink/pull/9299#discussion_r316478163
########## File path: docs/dev/api_concepts.zh.md ########## @@ -24,68 +24,46 @@ specific language governing permissions and limitations under the License. --> -Flink programs are regular programs that implement transformations on distributed collections -(e.g., filtering, mapping, updating state, joining, grouping, defining windows, aggregating). -Collections are initially created from sources (e.g., by reading from files, kafka topics, or from local, in-memory -collections). Results are returned via sinks, which may for example write the data to -(distributed) files, or to standard output (for example, the command line terminal). -Flink programs run in a variety of contexts, standalone, or embedded in other programs. -The execution can happen in a local JVM, or on clusters of many machines. - -Depending on the type of data sources, i.e. bounded or unbounded sources, you would either -write a batch program or a streaming program where the DataSet API is used for batch -and the DataStream API is used for streaming. This guide will introduce the basic concepts -that are common to both APIs but please see our -[Streaming Guide]({{ site.baseurl }}/dev/datastream_api.html) and -[Batch Guide]({{ site.baseurl }}/dev/batch/index.html) for concrete information about -writing programs with each API. - -**NOTE:** When showing actual examples of how the APIs can be used we will use -`StreamingExecutionEnvironment` and the `DataStream` API. The concepts are exactly the same -in the `DataSet` API, just replace by `ExecutionEnvironment` and `DataSet`. +Flink 程序是实现了分布式集合转换(例如过滤、映射、更新状态、join、分组、定义窗口、聚合)的规范化程序。集合初始创建自数据源(例如读取文件、kafka 主题,或本地内存中的集合)。结果通过 sink 返回,例如,它可以将数据写入(分布式)文件,或标准输出(例如命令行终端)。Flink 程序可以在多种环境中运行,独立运行或嵌入到其他程序中。可以在本地 JVM 中执行,也可以在多台机器的集群上执行。 + +针对有界和无界两种数据源类型,你可以使用 DataSet API 来编写批处理程序或使用 DataStream API 来编写流处理程序。本篇指南将介绍这两种 API 通用的基本概念,使用每种 API 编写程序的具体信息请查阅 Review comment: `使用每种 API 编写程序的具体信息请查阅` 去掉 `每种` 或者说重新写作 `具体使用 API 编写程序的方法请查阅` 或通顺一点。 ---------------------------------------------------------------- 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: us...@infra.apache.org With regards, Apache Git Services