docs: withKubernetesClient improved docs (#2564)

Signed-off-by: Attila Mészáros <[email protected]>

operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationServiceOverrider.java

@@ -11,6 +11,7 @@
 
 import io.fabric8.kubernetes.api.model.HasMetadata;
 import io.fabric8.kubernetes.client.KubernetesClient;
+import io.javaoperatorsdk.operator.Operator;
 import io.javaoperatorsdk.operator.api.monitoring.Metrics;
 import io.javaoperatorsdk.operator.api.reconciler.dependent.DependentResourceFactory;
 
@@ -121,6 +122,10 @@ public ConfigurationServiceOverrider withWorkflowExecutorService(
   /**
    * Replaces the default {@link KubernetesClient} instance by the specified one. This is the
    * preferred mechanism to configure which client will be used to access the cluster.
+   * <p>
+   * Note that when {@link Operator#stop()} is called, by default the client is closed even if
+   * explicitly provided with this method. Use {@link #withCloseClientOnStop(boolean)} to change
+   * this behavior.
    *
    * @param client the fully configured client to use for cluster access
    * @return this {@link ConfigurationServiceOverrider} for chained customization