diff --git a/keps/sig-apps/2879-ready-pods-job-status/README.md b/keps/sig-apps/2879-ready-pods-job-status/README.md index 5e3a7ba6ac17..5ad6aec5eb53 100644 --- a/keps/sig-apps/2879-ready-pods-job-status/README.md +++ b/keps/sig-apps/2879-ready-pods-job-status/README.md @@ -282,8 +282,15 @@ No. - API: PUT Job/status - Estimated throughput: at most one API call for each Job Pod reaching Ready - condition. + Estimated throughput: at most one additional API call for each Job Pod reaching + Ready condition per second. The reason is that the update of the `.status.ready` + field triggers another reconciliation of the Job controller. + + In order to constrain the number of reconciliations, the Job controller + batches and deduplicates reconciliation requests within a second. + + In other words, if there is another reconciliation request planned within a + second, the one triggered by `.status.ready` update is skipped. Originating component: job-controller