sjwiesman commented on a change in pull request #12559:
URL: https://github.com/apache/flink/pull/12559#discussion_r437646613



##########
File path: docs/concepts/timely-stream-processing.md
##########
@@ -24,17 +24,25 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-`TODO: add introduction`
-
 * This will be replaced by the TOC
 {:toc}
 
+## Introduction
+
+Timely steam processing is an extension of [stateful stream processing]({% link
+concepts/stateful-stream-processing.md %}) in which time plays some role in the
+computation. Among other things, this is the case when you do time series
+analysis, when doing aggregations based on certain time periods (typically
+called windows), or when you do event processing where the time when an event
+occured is important.
+
+In the following sections we will highlight some of the topics that you should
+consider when working with timely Flink Applications.
+

Review comment:
       Putting the toc after the intro is more consistent with the rest of the 
docs. 
   
   ```suggestion
   Timely steam processing is an extension of [stateful stream processing]({% 
link
   concepts/stateful-stream-processing.md %}) in which time plays some role in 
the
   computation. Among other things, this is the case when you do time series
   analysis, when doing aggregations based on certain time periods (typically
   called windows), or when you do event processing where the time when an event
   occurred is important.
   
   In the following sections, we will highlight some of the topics that you 
should
   consider when working with timely Flink Applications.
   
   * This will be replaced by the TOC
   {:toc}
   ```




----------------------------------------------------------------
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]


Reply via email to