minor #10461 Improve is_granted documentation (Jean85)

javiereguiluz · javiereguiluz · commit 5c52321b9ccb · 2018-10-12T10:22:11.000+02:00
This PR was squashed before being merged into the 2.8 branch (closes #10461). Discussion ---------- Improve is_granted documentation This improves the doc for the 'is_granted` Twig function. Under the hood, it calls `AuthorizationChecker::isGranted()` which accepts multiple attributes to be checked, but that's not clear. I've referred to the only other part of the doc where this is clear. Commits ------- 8ba3229 Improve is_granted documentation
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
@@ -302,15 +302,19 @@ is_granted
     {{ is_granted(role, object = null, field = null) }}
 
 ``role``
-    **type**: ``string``
+    **type**: ``string``, ``string[]``
 ``object`` *(optional)*
     **type**: ``object``
 ``field`` *(optional)*
     **type**: ``string``
 
-Returns ``true`` if the current user has the required role. Optionally,
-an object can be pasted to be used by the voter. More information can be
-found in :ref:`security-template`.
+Returns ``true`` if the current user has the required role, if only one 
+is passed; if more than one is passed, with an array, the behavior depends
+on how the :ref:`Access Decision Manager <components-security-access-decision-manager>`
+is configured; by default, the user has to have at least one of the passed roles.
+
+Optionally, an object can be pasted to be used by the voter. More information
+can be found in :ref:`security-template`.
 
 .. note::
 
