minor #12260 Move some doc contents in a Messenger article (javiereguiluz)

javiereguiluz · javiereguiluz · commit f52923b67392 · 2019-09-02T16:46:43.000+02:00
This PR was squashed before being merged into the 4.3 branch (closes #12260). Discussion ---------- Move some doc contents in a Messenger article This continues #11827. All credit goes to @noniagriconomie. Commits ------- 9707b69 Move some doc contents in a Messenger article
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
@@ -20,11 +20,6 @@ You can use this to get the value returned by the handler(s)::
     // or get info about all of handlers
     $handledStamps = $envelope->all(HandledStamp::class);
 
-A :class:`Symfony\\Component\\Messenger\\HandleTrait` also exists in order to ease
-leveraging a Messenger bus for synchronous needs.
-The :method:`Symfony\\Component\\Messenger\\HandleTrait::handle` method ensures
-there is exactly one handler registered and returns its result.
-
 Working with Command & Query Buses
 ----------------------------------
 
@@ -36,8 +31,10 @@ buses are central pieces of the application. Read Martin Fowler's
 As queries are usually synchronous and expected to be handled once,
 getting the result from the handler is a common need.
 
-To avoid boilerplate code, you can leverage the ``HandleTrait`` in any class
-that has a ``$messageBus`` property::
+A :class:`Symfony\\Component\\Messenger\\HandleTrait` exists to get the result
+of the handler when processing synchronously. It also ensures that exactly one
+handler is registered. The ``HandleTrait`` can be used in any class that has a
+``$messageBus`` property::
 
     // src/Action/ListItems.php
     namespace App\Action;
