[Serializer] Deprecate "context aware" interfaces

Author: mtarld

controller/error_pages.rst

@@ -226,7 +226,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
             ];
         }
 
-        public function supportsNormalization($data, string $format = null)
+        public function supportsNormalization($data, string $format = null, array $context = [])
         {
             return $data instanceof FlattenException;
         }

serializer/custom_encoders.rst

@@ -33,7 +33,7 @@ create your own encoder that uses the
             return Yaml::dump($data);
         }
 
-        public function supportsEncoding(string $format)
+        public function supportsEncoding(string $format, array $context = [])
         {
             return 'yaml' === $format;
         }
@@ -43,19 +43,12 @@ create your own encoder that uses the
             return Yaml::parse($data);
         }
 
-        public function supportsDecoding(string $format)
+        public function supportsDecoding(string $format, array $context = [])
         {
             return 'yaml' === $format;
         }
     }
 
-.. tip::
-
-    If you need access to ``$context`` in your ``supportsDecoding`` or
-    ``supportsEncoding`` method, make sure to implement
-    ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
-    or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
-
 
 Registering it in your app
 --------------------------

serializer/custom_normalizer.rst

@@ -22,10 +22,10 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
 
     use App\Entity\Topic;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Serializer\Normalizer\ContextAwareNormalizerInterface;
+    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-    class TopicNormalizer implements ContextAwareNormalizerInterface
+    class TopicNormalizer implements NormalizerInterface
     {
         private $router;
         private $normalizer;