From 1df880fa0076ff88479e9f79f2affbf820b236c1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Jul 2017 17:44:28 +0200
Subject: [PATCH 1/2] Stop using the deprecated "serializer.mapping.cache.apc"
 service

---
 serializer.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 3dcd59fa4a4..d41a40e969d 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -223,7 +223,7 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
         framework:
             # ...
             serializer:
-                cache: serializer.mapping.cache.apc
+                cache: serializer.mapping.cache.doctrine.apc
 
     .. code-block:: xml
 
@@ -239,7 +239,7 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
 
             <framework:config>
                 <!-- ... -->
-                <framework:serializer cache="serializer.mapping.cache.apc" />
+                <framework:serializer cache="serializer.mapping.cache.doctrine.apc" />
             </framework:config>
         </container>
 
@@ -249,10 +249,14 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
         $container->loadFromExtension('framework', array(
             // ...
             'serializer' => array(
-                'cache' => 'serializer.mapping.cache.apc',
+                'cache' => 'serializer.mapping.cache.doctrine.apc',
             ),
         ));
 
+.. versionadded:: 3.1
+    The ``serializer.mapping.cache.doctrine.apc`` service was introduced in 3.1
+    version to replace ``serializer.mapping.cache.apc``.
+
 Enabling a Name Converter
 -------------------------
 

From 5c58231cc5186805df19558d34c894ff1d64bb6c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Jul 2017 08:43:20 +0200
Subject: [PATCH 2/2] Removed some deprecated option and service

---
 serializer.rst | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index d41a40e969d..661a6e8724f 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -209,11 +209,10 @@ stored in one of the following locations:
 Enabling the Metadata Cache
 ---------------------------
 
-Metadata used by the Serializer component such as groups can be cached to
-enhance application performance. Any service implementing the ``Doctrine\Common\Cache\Cache``
-interface can be used.
-
-A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
+Metadata used by the serializer can be cached to improve application performance.
+By default, Symfony uses the same `APCu`_ (or APC for PHP < 5.5) cache already
+configured in the application, but you can override it using any other service
+implementing the ``Doctrine\Common\Cache\Cache`` interface:
 
 .. configuration-block::
 
@@ -223,7 +222,7 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
         framework:
             # ...
             serializer:
-                cache: serializer.mapping.cache.doctrine.apc
+                cache: id.of.my.own.cache.service
 
     .. code-block:: xml
 
@@ -239,7 +238,7 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
 
             <framework:config>
                 <!-- ... -->
-                <framework:serializer cache="serializer.mapping.cache.doctrine.apc" />
+                <framework:serializer cache="id.of.my.own.cache.service" />
             </framework:config>
         </container>
 
@@ -249,14 +248,10 @@ A service leveraging `APCu`_ (and APC for PHP < 5.5) is built-in.
         $container->loadFromExtension('framework', array(
             // ...
             'serializer' => array(
-                'cache' => 'serializer.mapping.cache.doctrine.apc',
+                'cache' => 'id.of.my.own.cache.service',
             ),
         ));
 
-.. versionadded:: 3.1
-    The ``serializer.mapping.cache.doctrine.apc`` service was introduced in 3.1
-    version to replace ``serializer.mapping.cache.apc``.
-
 Enabling a Name Converter
 -------------------------