symfony
diff --git a/‎components/cache.rst
Copy file name to clipboardExpand all lines: components/cache.rst
+21-9Lines changed: 21 additions & 9 deletions b/‎components/cache.rst
Copy file name to clipboardExpand all lines: components/cache.rst
+21-9Lines changed: 21 additions & 9 deletions
@@ -192,17 +192,26 @@ Now you can create, retrieve, update and delete items using this cache pool::
 
 For a list of all of the supported adapters, see :doc:`/components/cache/cache_pools`.
 
-Serializing Data
-----------------
+Marshalling (Serializing) Data
+------------------------------
 
-When an item is stored in the cache, it is serialised to a string. It is a class
-implementing :class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`
-that is responsible for serializing and unserializing. Or to be technically correct:
-to ``marshall()`` and to ``unmarshall()``.
+.. note::
+
+    `Marshalling`_ and `serializing`_ are similar concepts. Serializing is the
+    process of translating an object state into a format that can be stored
+    (e.g. in a file). Marshalling is the process of translating both the object
+    state and its codebase into a format that can be stored or transmitted.
+
+    Unmarshalling an object produces a copy of the original object, possibly by
+    automatically loading the class definitions of the object.
+
+Symfony uses *marshallers* (classes which implement
+:class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`) to process
+the cache items before storing them.
 
-The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` is using PHP's
-``serialize()`` or ``igbinary_serialize()`` if the Igbinary extension is installed.
-There are other marshallers that will encrypt or compress the data before storing it::
+The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
+``serialize()`` or ``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
+There are other *marshallers* that can encrypt or compress the data before storing it::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
     use Symfony\Component\Cache\DefaultMarshaller;
@@ -224,3 +233,6 @@ Advanced Usage
 .. _`Cache Contracts`: https://github.com/symfony/contracts/blob/master/Cache/CacheInterface.php
 .. _`Stampede prevention`: https://en.wikipedia.org/wiki/Cache_stampede
 .. _Probabilistic early expiration: https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
+.. _`Marshalling`: https://en.wikipedia.org/wiki/Marshalling_(computer_science)
+.. _`serializing`: https://en.wikipedia.org/wiki/Serialization
+.. _`Igbinary extension`: https://github.com/igbinary/igbinary