feature: add the context key documentation and link to encoders documentation in serializer

Author: Simperfit

components/serializer.rst

@@ -605,23 +605,7 @@ There are several types of normalizers available:
 Encoders
 --------
 
-The Serializer component supports many formats out of the box:
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
-    This class encodes and decodes data in JSON_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
-    This class encodes and decodes data in XML_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
-    This encoder encodes and decodes data in YAML_. This encoder requires the
-    :doc:`Yaml Component </components/yaml>`.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
-    This encoder encodes and decodes data in CSV_.
-
-All these encoders are enabled by default when using the Symfony Standard Edition
-with the serializer enabled.
+Please see :doc:`the encoders documentation </serializer/encoders.rst>`.
 
 .. _component-serializer-handling-circular-references:
 

serializer/encoders.rst

@@ -25,17 +25,35 @@ Built-in Encoders
 
 The Serializer component provides built-in encoders:
 
-* :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder` to encode/decode CSV
-* :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder` to encode/decode JSON
-* :class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder` to encode/decode XML
-* :class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder` to encode/decode Yaml
+:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
+    This class encodes and decodes data in JSON_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
+    This class encodes and decodes data in XML_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
+    This encoder encodes and decodes data in YAML_. This encoder requires the
+    :doc:`Yaml Component </components/yaml>`.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
+    This encoder encodes and decodes data in CSV_.
+
+All these encoders are enabled by default when using the Symfony Standard Edition
+with the serializer enabled.
 
 The ``JsonEncoder``
 ~~~~~~~~~~~~~~~~~~~
 
 The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
 :phpfunction:`json_encode` and :phpfunction:`json_decode` functions.
 
+The ``CsvEncoder``
+~~~~~~~~~~~~~~~~~~~
+
+The ``CsvEncoder`` encodes to and decodes from CSV.
+
+You can pass the context key ``as_collection`` in order to have the results always as a collection.
+
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -64,6 +82,8 @@ Be aware that this encoder will consider keys beginning with ``@`` as attributes
     //     <foo bar="value" />
     // </response>
 
+You can pass the context key ``as_collection`` in order to have the results always as a collection.
+
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~