diff --git a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationServiceProvider.java b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationServiceProvider.java
index 1e6dd660cf..50419f6a5d 100644
--- a/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationServiceProvider.java
+++ b/operator-framework-core/src/main/java/io/javaoperatorsdk/operator/api/config/ConfigurationServiceProvider.java
@@ -2,6 +2,10 @@
 
 import java.util.function.Consumer;
 
+/**
+ * For internal usage only, to avoid passing the operator configuration around. Preferred way to get
+ * to the ConfigurationService is via the reconciliation context.
+ */
 public class ConfigurationServiceProvider {
   static final ConfigurationService DEFAULT =
       new BaseConfigurationService(Utils.loadFromProperties());