NGSTACK-805: adjust configuration

bundle/Resources/config/messenger.yaml

@@ -1,5 +1,4 @@
 messenger:
-    reset_on_message: true
     transports:
         netgen_ibexa_search_extra_asynchronous_indexing:
             dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
@@ -46,6 +45,4 @@ messenger:
         'Netgen\IbexaSearchExtra\Core\Search\Common\Messenger\Message\Search\User\UpdateUser': netgen_ibexa_search_extra_asynchronous_indexing
     default_bus: messenger.bus.default
     buses:
-        messenger.bus.default:
-            middleware:
-                - doctrine_ping_connection
+        messenger.bus.default: ~

docs/reference/asynchronous_indexing.rst

@@ -19,9 +19,28 @@ In order to enable asynchronous indexing, use the following configuration:
 
 `Default Messenger component configuration <https://github.com/netgen/ibexa-search-extra/blob/master/bundle/Resources/config/messenger.yaml>`_
 will be automatically loaded. In case you want to use a different configuration, you will have to override it in the
-project code. Additionally, you will need to start the consumer to process the queue. For the default configuration,
-you can do that with:
+project code. Note that it would be recommended to configure the bus used with ``doctrine_ping_connection`` middleware,
+since the asynchronous indexing consumer will typically be a long running process, which could otherwise lose the
+connection to the database. This setting is not included in the default configuration as it's a global setting and you
+might not want to have it enabled by default. You can enable it in the ``buses`` part of the Messenger configuration
+with:
+
+.. code-block:: yaml
+
+    buses:
+        messenger.bus.default:
+            middleware:
+                - doctrine_ping_connection
+
+Additionally, you will need to start the consumer to process the queue. For the default configuration, you can do that
+with:
 
 .. code-block:: console
 
     bin/console messenger:consume netgen_ibexa_search_extra_asynchronous_indexing --time-limit=1800 --limit=4096
+
+.. note::
+
+    Event subscribers use a Messenger message bus service named ``netgen.ibexa_search_extra.asynchronous_indexing.messenger.bus``,
+    which is an alias to the default ``messenger.default_bus`` service. This enables override of the message bus used in
+    event listeners when needed.