Add note

1 files changed, 5 insertions, 0 deletions

diff --git a/orchestrator/src/main/java/com/yahoo/vespa/orchestrator/status/ZookeeperStatusService.java b/orchestrator/src/main/java/com/yahoo/vespa/orchestrator/status/ZookeeperStatusService.java
index 5a16f4411b5..c23334d865e 100644
--- a/orchestrator/src/main/java/com/yahoo/vespa/orchestrator/status/ZookeeperStatusService.java
+++ b/orchestrator/src/main/java/com/yahoo/vespa/orchestrator/status/ZookeeperStatusService.java
@@ -77,6 +77,11 @@ public class ZookeeperStatusService implements StatusService {
         }
     }
 
+    /**
+     * Cache is checked for freshness when this mapping is created, and may be invalidated again later
+     * by other users of the cache. Since this function is backed by the cache, any such invalidations
+     * will be reflected in the returned mapping; all users of the cache collaborate in repopulating it.
+     */
     @Override
     public Function<ApplicationInstanceReference, Set<HostName>> getSuspendedHostsByApplication() {
         Map<ApplicationInstanceReference, Set<HostName>> suspendedHostsByApplication = getValidCache();