Improve comment more

Polymer · May 23, 2017 · 3987708 · 3987708
1 parent fa1469a
commit 3987708
Showing 1 changed file with 11 additions and 3 deletions.
diff --git a/lib/mixins/property-effects.html b/lib/mixins/property-effects.html
@@ -1442,9 +1442,17 @@
       }
 
       // NOTE: We ensure clients either enable or flush as appropriate. This
-      // handles two corner cases: (1) clients flush properly when
-      // connected/enabled before the host enables, (2) clients enable properly
-      // when not connected/enabled when the host flushes.
+      // handles two corner cases:
+      // (1) clients flush properly when connected/enabled before the host
+      // enables; e.g.
+      //   (a) Templatize stamps with no properties and does not flush and
+      //   (b) the instance is inserted into dom and
+      //   (c) then the instance flushes.
+      // (2) clients enable properly when not connected/enabled when the host
+      // flushes; e.g.
+      //   (a) a template is runtime stamped and not yet connected/enabled
+      //   (b) a host sets a property, causing stamped dom to flush
+      //   (c) the stamped dom enables.
       __enableOrFlushClients() {
         let clients = this.__dataPendingClients;
         if (clients) {