Merge pull request #520 from FriendsOfSymfony/invalidate-annotation-only-unsafe-requests-1

Explain invalidation applies to unsafe requests

Author: dbu

Resources/doc/reference/annotations.rst

@@ -28,6 +28,10 @@ Invalidate a path::
  {
  }
 
+When `editAction()` returns a successful response to an :term:`unsafe <safe>`
+HTTP request (POST, PUT, PATCH or DELETE), the paths `/articles` and
+`/articles/latest` will be invalidated.
+
 See :doc:`/features/invalidation` for more information.
 
 .. _invalidateroute:
@@ -47,6 +51,9 @@ Invalidate a route with parameters::
  {
  }
 
+Similarly to ``@InvalidatePath`` above, any successful response to an
+:term:`unsafe <safe>` request will invalidate the two routes.
+
 You can also use expressions_ in the route parameter values. This obviously
 :ref:`requires the ExpressionLanguage component <requirements>`. To invalidate
 route ``articles`` with the ``number`` parameter set to ``123``, do::