docs: explanation for max maxReconciliationInterval (operator-framework#2745)

Author: csviri

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
    */