diff --git a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/ControllerConfiguration.java b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/ControllerConfiguration.java
index 29bf0b670f..d407ed0fc6 100644
--- a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/ControllerConfiguration.java
+++ b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/reconciler/ControllerConfiguration.java
@@ -44,7 +44,9 @@
 
   /**
    * Optional configuration of the maximal interval the SDK will wait for a reconciliation request
-   * to happen before one will be automatically triggered.
+   * to happen before one will be automatically triggered. The intention behind this feature is to
+   * have a failsafe, not to artificially force repeated reconciliations. For that use {@link
+   * UpdateControl#rescheduleAfter(long)}.
    *
    * @return the maximal reconciliation interval configuration
    */