diff --git a/docs/modules/ROOT/pages/kubernetes-awareness.adoc b/docs/modules/ROOT/pages/kubernetes-awareness.adoc
index 6e939d82..41793a5a 100644
--- a/docs/modules/ROOT/pages/kubernetes-awareness.adoc
+++ b/docs/modules/ROOT/pages/kubernetes-awareness.adoc
@@ -28,6 +28,19 @@ In versions of Spring Cloud Kubernetes prior to `3.0.x`, Kubernetes awareness wa
 property was removed and is un-supported. Instead, we use Spring Boot API: https://docs.spring.io/spring-boot/docs/current/api/org/springframework/boot/autoconfigure/condition/ConditionalOnCloudPlatform.html[ConditionalOnCloudPlatform].
 If it is needed to explicitly enable or disable this awareness, use `spring.main.cloud-platform=NONE/KUBERNETES`.
 
+- Another breaking change is the additional `list` verb needed for loading configmaps/secrets. For example:
+
+```
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: cluster-role
+rules:
+  - apiGroups: ["", "extensions", "apps", "discovery.k8s.io"]
+    resources: ["configmaps", "pods", "services", "endpoints", "secrets", "endpointslices"]
+    verbs: ["get", "list", "watch"]
+```
+
 [[kubernetes-profile-autoconfiguration]]
 == Kubernetes Profile Autoconfiguration