Merge pull request #553 from Tatsh/add-cache-namespace-documentation

Add documentation about the 'namespace' option

Author: lsmith77

reference/configuration/phpcr_odm.rst

@@ -461,6 +461,7 @@ not configure anything here, the ODM services will not be loaded.
                     instance_class: ~
                     class:          ~
                     id:             ~
+                    namespace:      ~
 
 
     .. code-block:: xml
@@ -496,6 +497,7 @@ not configure anything here, the ODM services will not be loaded.
                         instance-class="null"
                         class="null"
                         id="null"
+                        namespace="null"
                     />
                 </odm>
             </config>
@@ -528,6 +530,7 @@ not configure anything here, the ODM services will not be loaded.
                     'instance_class' => null,
                     'class'          => null,
                     'id'             => null,
+                    'namespace'      => null,
                 ),
             ),
         ));
@@ -581,7 +584,16 @@ names without any actual configuration.
 metadata_cache_driver
 """""""""""""""""""""
 
-Configure a cache driver for the Doctrine metadata. This is the same as for `Doctrine ORM`_.
+Configure a cache driver for the Doctrine metadata. This is the same as for
+`Doctrine ORM`_.
+
+The ``namespace`` value is useful if you are using one primary caching server
+for multiple sites that have similar code in their respective ``vendor/``
+directories. By default, Symfony will try to generate a unique namespace
+value for each application but if code is very similar between two
+applications, it is very easy to have two applications share the same
+namespace. This option also prevents Symfony from needing to re-build
+application cache on each Composer update on a newly generated namespace.
 
 General Settings
 ~~~~~~~~~~~~~~~~