README: Review changes

edenhill · web-flow · commit 6fa014f0f6b2 · 2018-04-17T20:26:32.000+02:00
diff --git a/README.md b/README.md
@@ -51,15 +51,16 @@ def delivery_report(err, msg):
         print('Message delivered to {} [{}]'.format(msg.topic(), msg.partition()))
 
 for data in some_data_source:
-    # Trigger delivery report callbacks from previous produce() calls
+    # Trigger any available delivery report callbacks from previous produce() calls
     p.poll(0)
 
-    # Asynchronously produce a message, the optional but recommended
-    # delivery report callback will be triggered from poll()
-    # when the message has been successfully delivered or failed permanently.
+    # Asynchronously produce a message, the delivery report callback
+    # will be triggered from poll() above, or flush() below, when the message has
+    # been successfully delivered or failed permanently.
     p.produce('mytopic', data.encode('utf-8'), callback=delivery_report)
 
-# Wait for any outstanding messages to be delivered
+# Wait for any outstanding messages to be delivered and delivery report
+# callbacks to be triggered.
 p.flush()
 ```
 
