docs: Simplify event processor comment wording

Author: jsonbailey

ldclient/impl/events/async_event_processor.py

@@ -133,10 +133,9 @@ async def _run_main_loop(self):
                 elif message.type == 'diagnostic':
                     self._send_and_reset_diagnostics()
                 elif message.type == 'flush_and_wait':
-                    # Ensure the buffered batch is actually handed to a worker
-                    # before reporting success; under saturation the first
-                    # trigger may leave the events buffered, so wait for a free
-                    # worker and retry.
+                    # Do not report success until a worker takes the batch.
+                    # When all workers are busy, the first trigger leaves the
+                    # events buffered, so wait for a free worker and try again.
                     while not self._trigger_flush():
                         await self._flush_workers.wait()
                     await self._flush_workers.wait()

ldclient/impl/events/event_processor_common.py

@@ -89,7 +89,7 @@ def clear(self):
 
 
 class EventOutputFormatter:
-    """Transforms buffered events into the LaunchDarkly wire-format output payload. Performs no I/O."""
+    """Transforms buffered events into the output payload sent to LaunchDarkly. Performs no I/O."""
 
     def __init__(self, config: PrivateAttributesConfig):
         self._context_formatter = EventContextFormatter(