symfony · xabbuh · Nov 5, 2016 · Oct 21, 2016
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
@@ -10,20 +10,22 @@ change in the state of your model. The most basic kind of invalidation is direct
 items deletion. But when the state of a primary resource has spread accross
 several cached items, keeping them in sync can be difficult.

-The Symfony Cache component provides two mechanisms to help solve this problem:
+The Symfony Cache component provides two mechanisms to help solving this problem:

-* Tags based invalidation for managing data dependencies;
-* Expiration based invalidation for time related dependencies.
+* :ref:`Tags based invalidation <cache-component-tags>` for managing data dependencies;
+* :ref:`Expiration based invalidation <cache-component-expiration>` for time related dependencies.

-.. versionadded:: 3.2
-    Tags based invalidation was introduced in Symfony 3.2.
+.. _cache-component-tags:

 Using Cache Tags
 ----------------

+.. versionadded:: 3.2
+    Tags based invalidation was introduced in Symfony 3.2.
+
 To benefit from tags based invalidation, you need to attach the proper tags to
-each cached items. Each tag is a plain string identifier that you can use at any
-time to trigger the removal of all items that had this tag attached to them.
+each cached item. Each tag is a plain string identifier that you can use at any
+time to trigger the removal of all items associated with this tag.

 To attach tags to cached items, you need to use the
 :method:`Symfony\\Component\\Cache\\CacheItem::tag` method that is implemented by
@@ -36,14 +38,14 @@ cache items, as returned by cache adapters::
    $item->tag(array('tag_2', 'tag_3'));
    $cache->save($item);

-If ``$cache`` implements :class:`Symfony\\Component\\Cache\\TagAwareAdapterInterface`,
+If ``$cache`` implements :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface`,
 you can invalidate the cached items by calling
-:method:`Symfony\\Component\\Cache\\TagAwareAdapterInterface::invalidateTags`::
+:method:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface::invalidateTags`::

    // invalidate all items related to `tag_1` or `tag_3`
    $cache->invalidateTags(array('tag_1', 'tag_3'));

-    // if you know the cache key, you can of course delete directly
+    // if you know the cache key, you can also delete the item directly
    $cache->deleteItem('cache_key');

 Using tags invalidation is very useful when tracking cache keys becomes difficult.
@@ -78,6 +80,8 @@ your fronts and have very fast invalidation checks::
        new RedisAdapter('redis://localhost')
    );

+.. _cache-component-expiration:
+
 Using Cache Expiration
 ----------------------


diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
@@ -113,6 +113,9 @@ See the method's docblock for more options.
 PDO & Doctrine DBAL Cache Adapter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+.. versionadded:: 3.2
+    The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.
+
 This adapter stores the cached items a SQL database accessed through a PDO or a
 Doctrine DBAL connection::

@@ -130,9 +133,6 @@ Doctrine DBAL connection::
        $options = array()
    );

-.. versionadded:: 3.2
-    The PDO & Doctrine DBAL adapter was introduced in Symfony 3.2.
-
 Chain Cache Adapter
 ~~~~~~~~~~~~~~~~~~~