@@ -126,7 +126,7 @@ public boolean containsKey(Object key) {
 
     @Override
     public Set<Entry<String, String>> entrySet() {
-      // The unmodifiable wrapper caches views; keep them live but pin each iterator to one snapshot.
+      // Keep the unmodifiable wrapper's cached views live; each iterator captures a snapshot.
       return new AbstractSet<>() {
         @Override
         public Iterator<Entry<String, String>> iterator() {
 
@@ -31,8 +31,9 @@
  * complete, immutable copy of the ConfigMap data. Iteration (including {@code forEach}) and copies
  * such as {@code new HashMap<>(map)} observe one complete version. Views returned by {@code
  * entrySet()}, {@code keySet()}, and {@code values()} remain live, but each iterator retains the
- * version captured when it was created. Separate calls to {@code get} may observe different versions
- * if a refresh occurs between them; they are not a transaction.
+ * version captured when it was created. Separate operations on the map or its views (for example,
+ * two {@code get} calls, or {@code size()} followed by iteration) may observe different versions if
+ * a refresh occurs between them; they are not a transaction.
  *
  * <p>Unlike the previously injected mutable cache map, the map and its views are now read-only.
  * Mutating operations throw {@link UnsupportedOperationException}. Copy the map into an
 
@@ -12,9 +12,9 @@
 */
 package io.kubernetes.client.spring.extended.manifests;
 
-import static org.awaitility.Awaitility.await;
 import static org.assertj.core.api.Assertions.assertThat;
 import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.awaitility.Awaitility.await;
 
 import io.kubernetes.client.openapi.models.V1ConfigMap;
 import io.kubernetes.client.spring.extended.manifests.annotation.FromConfigMap;