diff --git a/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/ConfigMapDependentResource.java b/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/ConfigMapDependentResource.java
index cfe0f79a0e..19a8e03845 100644
--- a/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/ConfigMapDependentResource.java
+++ b/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/ConfigMapDependentResource.java
@@ -51,6 +51,9 @@ public ConfigMap update(ConfigMap actual, ConfigMap target, WebPage primary,
     var ns = actual.getMetadata().getNamespace();
     log.info("Restarting pods because HTML has changed in {}",
         ns);
+    // not that this is not necessary, eventually mounted config map would be updated, just this way
+    // is much faster; what is handy for demo purposes.
+    // https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#mounted-configmaps-are-updated-automatically
     getKubernetesClient()
         .pods()
         .inNamespace(ns)
diff --git a/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/WebPageReconciler.java b/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/WebPageReconciler.java
index 19b130da88..5d50fd8e2a 100644
--- a/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/WebPageReconciler.java
+++ b/sample-operators/webpage/src/main/java/io/javaoperatorsdk/operator/sample/WebPageReconciler.java
@@ -126,6 +126,9 @@ public UpdateControl<WebPage> reconcile(WebPage webPage, Context<WebPage> contex
       existingIngress.ifPresent(
           ingress -> kubernetesClient.resource(ingress).delete());
 
+    // not that this is not necessary, eventually mounted config map would be updated, just this way
+    // is much faster; what is handy for demo purposes.
+    // https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#mounted-configmaps-are-updated-automatically
     if (previousConfigMap != null && !StringUtils.equals(
         previousConfigMap.getData().get(INDEX_HTML),
         desiredHtmlConfigMap.getData().get(INDEX_HTML))) {