Improve comment more

Author: Steven Orvell

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) {