improving formulation

Author: dbu

bundles/phpcr_odm/events.rst

@@ -87,10 +87,10 @@ use this configuration:
     subscriber with the names of the subscribed events, just as when using an
     event listener.
 
-More information with PHP code examples for the doctrine event system
-integration is in the `Symfony cookbook entry on ORM events`_.
+You can find more information and examples of the doctrine event system
+in "`How to Register Event Listeners and Subscribers`_" of the core documentation.
 
 .. _`Doctrine PHPCR-ODM event system documentation`: http://docs.doctrine-project.org/projects/doctrine-phpcr-odm/en/latest/reference/events.html
 .. _`Symfony event subscriber`: http://symfony.com/doc/master/components/event_dispatcher/introduction.html#using-event-subscribers
 .. _`Doctrine ORM events`: http://symfony.com/doc/current/cookbook/doctrine/event_listeners_subscribers.html
-.. _`Symfony cookbook entry on ORM events`: http://symfony.com/doc/current/cookbook/doctrine/event_listeners_subscribers.html
+.. _`How to Register Event Listeners and Subscribers`: http://symfony.com/doc/current/cookbook/doctrine/event_listeners_subscribers.html

reference/configuration/phpcr_odm.rst

@@ -617,7 +617,9 @@ not configure anything here, the ODM services will not be loaded.
 configuration_id
 """"""""""""""""
 
-@lsmith77 ?
+**type**: ``string``, **default**: ``doctrine_phpcr.odm.configuration``
+
+The service to use as base for building the PHPCR-ODM configuration.
 
 auto_mapping
 """"""""""""
@@ -661,7 +663,7 @@ names without any actual configuration.
 metadata_cache_driver
 """""""""""""""""""""
 
-@lsmith77 ?
+Configure a cache driver for the Doctrine metadata. This is the same as for `Doctrine ORM`_.
 
 General Settings
 ~~~~~~~~~~~~~~~~
@@ -716,3 +718,4 @@ For tuning the output of the ``doctrine:phpcr:dump`` command.
 .. _`the midgard/phpcr package`: http://packagist.org/packages/midgard/phpcr
 .. _`the getting started document`: http://midgard-project.org/phpcr/#getting_started
 .. _`official Midgard PHPCR documentation`: http://midgard-project.org/phpcr/
+.. _`Doctrine ORM`: http://symfony.com/doc/current/reference/configuration/doctrine.html#caching-drivers