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

Reply via email to