diff --git a/lib/mixins/property-effects.html b/lib/mixins/property-effects.html
index 069a947d26..1d48b442e3 100644
--- a/lib/mixins/property-effects.html
+++ b/lib/mixins/property-effects.html
@@ -1441,6 +1441,10 @@
         }
       }
 
+      // NOTE: We ensure clients either enable or flush as appropriate. This
+      // handles two corner cases: (1) clients that are connected/enabled before
+      // the host enables flush properly, (2) clients that are not
+      // connected/enabled when the host flushes are properly enabled.
       __enableOrFlushClients() {
         let clients = this.__dataPendingClients;
         if (clients) {