From 14a995e8a046d103cc2f3d9296fb5e16b1e096ae Mon Sep 17 00:00:00 2001
From: Dana Katz <danakatz@users.noreply.github.com>
Date: Mon, 20 Aug 2018 10:44:43 -0500
Subject: [PATCH] Add note about cron job suspend behavior (#9904)

---
 content/en/docs/tasks/job/automated-tasks-with-cron-jobs.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/content/en/docs/tasks/job/automated-tasks-with-cron-jobs.md b/content/en/docs/tasks/job/automated-tasks-with-cron-jobs.md
index b73ab24440..235deb8f19 100644
--- a/content/en/docs/tasks/job/automated-tasks-with-cron-jobs.md
+++ b/content/en/docs/tasks/job/automated-tasks-with-cron-jobs.md
@@ -168,6 +168,11 @@ If it is set to `true`, all subsequent executions are suspended.
 This setting does not apply to already started executions.
 Defaults to false.
 
+{{< caution >}}
+**Caution:** Executions that are suspended during their scheduled time count as missed jobs.
+When `.spec.suspend` changes from `true` to `false` on an existing cron job without a [starting deadline](#starting-deadline), the missed jobs are scheduled immediately.
+{{< /caution >}}
+
 ### Jobs History Limits
 
 The `.spec.successfulJobsHistoryLimit` and `.spec.failedJobsHistoryLimit` fields are optional.