symfony
diff --git a/‎components/serializer.rst
Copy file name to clipboardExpand all lines: components/serializer.rst
+15-10Lines changed: 15 additions & 10 deletions b/‎components/serializer.rst
Copy file name to clipboardExpand all lines: components/serializer.rst
+15-10Lines changed: 15 additions & 10 deletions
@@ -1089,18 +1089,18 @@ These are the options available:
 ``remove_empty_tags``
     If set to true, removes all empty tags in the generated XML.
 
-Handling Value Objects
-----------------------
-
-Value Objets are difficult to handle because they often require parameters in the constructor. If the input omit one
-of theses parameters the serializer will throw an exception because it can't create the object.
+Handling Constructor Arguments
+------------------------------
 
-To support Value Objects you will need to define the context option ``default_constructor_arguments``::
+If the constructor of a class defines arguments, as usually happens with
+`Value Objects`_, the serializer won't be able to create the object. In those
+cases, use the ``default_constructor_arguments`` context option::
 
     use Symfony\Component\Serializer\Serializer;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-    class MyObj {
+    class MyObj
+    {
         private $foo;
         private $bar;
 
@@ -1114,9 +1114,13 @@ To support Value Objects you will need to define the context option ``default_co
     $normalizer = new ObjectNormalizer($classMetadataFactory);
     $serializer = new Serializer(array($normalizer));
 
-    $data = $serializer->denormalize(['foo' => 'Hello'], 'MyObj', array('default_constructor_arguments' => array(
-        'MyObj' => array('foo' => '', 'bar' => ''),
-    )));
+    $data = $serializer->denormalize(
+        array('foo' => 'Hello'),
+        'MyObj',
+        array('default_constructor_arguments' => array(
+            'MyObj' => array('foo' => '', 'bar' => ''),
+        )
+    ));
     // $data = new MyObj('Hello', '');
 
 Recursive Denormalization and Type Safety
@@ -1302,3 +1306,4 @@ Learn more
 .. _YAML: http://yaml.org/
 .. _CSV: https://tools.ietf.org/html/rfc4180
 .. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
+.. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object