[
https://issues.apache.org/jira/browse/FLINK-2363?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14627799#comment-14627799
]
ASF GitHub Bot commented on FLINK-2363:
---------------------------------------
Github user fhueske commented on a diff in the pull request:
https://github.com/apache/flink/pull/913#discussion_r34661812
--- Diff: docs/internals/through_stack.md ---
@@ -0,0 +1,181 @@
+---
+title: "From Program to Result: A Dive through Stack and Execution"
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+This page explains what happens when you execute a Flink program
(streaming or streaming).
+It covers the complete life cycle, from <emph>client-side
pre-flight</emph>, to <emph>JobManager</emph>,
+and <emph>TaskManager</emph>.
+
+Please refer to the [Overview Page](../index.html) for a high-level
overview of the processes and the stack.
+
+* This will be replaced by the TOC
+{:toc}
+
+
+## Batch API: DataSets to JobGraph
+
+## Streaming API: DataStreams to JobGraph
+
+## Client: Submitting a Job, Receiving Statistics & Results
+
+
+
+## JobManager: Receiving and Starting a Job
+
+parallel operator instance
+
+execution attempts
+
+
+## TaskManager: Running Tasks
+
+The *{% gh_link
flink-runtime/src/main/scala/org/apache/flink/runtime/taskmanager/TaskManager.scala
"TaskManager" %}*
+is the worker process in Flink. It runs the *{% gh_link
flink-runtime/src/main/java/org/apache/flink/runtime/taskmanager/Task.java
"Tasks" %}*,
+which execute a parallel operator instance.
+
+The TaskManager itself is an Akka actor and has many utility components,
such as:
+
+ - The *{% gh_link
flink-runtime/src/main/java/org/apache/flink/runtime/io/network/NetworkEnvironment.java
"NetworkEnvironment" %}*, which takes care of all data exchanges (streamed and
batched) between TaskManagers. Cached data sets in Flink are also cached
streams, to the network environment is responsible for that as well.
--- End diff --
Last sentence should be rephrased.
> Add an end-to-end overview of program execution in Flink to the docs
> --------------------------------------------------------------------
>
> Key: FLINK-2363
> URL: https://issues.apache.org/jira/browse/FLINK-2363
> Project: Flink
> Issue Type: Improvement
> Components: Documentation
> Reporter: Stephan Ewen
>
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
