zentol commented on a change in pull request #15435:
URL: https://github.com/apache/flink/pull/15435#discussion_r604726069
##########
File path: docs/content.zh/docs/deployment/cli.md
##########
@@ -169,6 +169,11 @@ barrier. This will make all registered event-time timers
fire, thus flushing out
is waiting for a specific watermark, e.g. windows. The job will keep running
until all sources properly
shut down. This allows the job to finish processing all in-flight data.
+{{< hint danger >}}
+Use the `--drain` flag if you want to terminate the job permanently.
+If you want to resume the job at a later point in time, then do not drain the
pipeline because it could lead to incorrect results.
Review comment:
Should we clarify that the incorrect results happen when the job is
resumed?
```suggestion
If you want to resume the job at a later point in time, then do not drain
the pipeline because it could lead to incorrect results when the job is resumed.
```
--
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]
