Reword

Author: javiereguiluz

doctrine/event_listeners_subscribers.rst

@@ -16,9 +16,17 @@ whenever an object in your database is saved.
 
 Doctrine defines two types of objects that can listen to Doctrine events:
 listeners and subscribers. Both are very similar, but listeners are a bit
-more straightforward. For more, see `The Event System`_ on Doctrine's website.
+more straightforward. For more, see `The Event System`_ on Doctrine's documentation.
 
-The Doctrine website also explains all existing events that can be listened to.
+Before using them, keep in mind that Doctrine events are intended for
+persistence hooks (i.e. *"save also this when saving that"*). They should not be
+used for domain logic, such as logging changes, setting ``updatedAt`` and
+``createdAt`` properties, etc.
+
+.. seealso::
+
+    This article covers listeners and subscribers for Doctrine ORM. If you are
+    using ODM for MongoDB, read the `DoctrineMongoDBBundle documentation`_.
 
 Configuring the Listener/Subscriber
 -----------------------------------
@@ -85,11 +93,6 @@ managers that use this connection.
             ->addTag('doctrine.event_subscriber', ['connection' => 'default'])
         ;
 
-.. tip::
-
-    If you're using Doctrine with MongoDB, you should use ``doctrine_mongodb.odm.event_listener``
-    as the tag name for the event listener service.
-
 Creating the Listener Class
 ---------------------------
 
@@ -302,3 +305,4 @@ numbers mean that listeners are invoked earlier.
 
 .. _`The Event System`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html
 .. _`the DoctrineBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html
+.. _`DoctrineMongoDBBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html