Minor tweaks

Author: javiereguiluz

reference/formats/yaml.rst

@@ -321,27 +321,28 @@ The YAML specification defines some tags to set the type of any data explicitly:
             Pz7Y6OjuDg4J+fn5OTk6enp
             56enmleECcgggoBADs=
 
-Symfony Specific Tags
-~~~~~~~~~~~~~~~~~~~~~
+Symfony Specific Features
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The YAML component provides a few additional tags that brings a few
-features when parsed in your PHP code:
+The Yaml component provides some additional features that are not part of the
+official YAML specification but are useful in Symfony applications:
 
-* ``!php/const`` allows to use a constant name defined in a PHP file. This
-  tag takes a constant FQCN as its argument:
+* ``!php/const`` allows to get the value of a PHP constant. This tag takes the
+  fully-qualified class name of the constant as its argument:
 
-.. code-block:: yaml
+  .. code-block:: yaml
 
-    data:
-        page_limit: !php/const App\Pagination\Paginator::PAGE_LIMIT
+      data:
+          page_limit: !php/const App\Pagination\Paginator::PAGE_LIMIT
 
 * ``!php/object`` allows to pass the serialized representation of a PHP
-  object, which will be deserialized when the parsing is done:
+  object (created with the `serialize()`_ function), which will be deserialized
+  when parsing the YAML file:
 
-.. code-block:: yaml
+  .. code-block:: yaml
 
-    data:
-        my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
+      data:
+          my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
 
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -360,3 +361,4 @@ The following YAML features are not supported by the Symfony Yaml component:
 
 .. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
 .. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
+.. _`serialize()`: https://www.php.net/manual/en/function.serialize.php