Fixed syntax issues, minor typos and markup issues

Author: javiereguiluz

Diff for: cookbook/security/voters_data_permission.rst

@@ -25,7 +25,7 @@ How Symfony Uses Voters
 
 In order to use voters, you have to understand how Symfony works with them.
 All voters are called each time you use the ``isGranted()`` method on Symfony's
-authorization checker (i.e. the ``security.authorization_checker`` service). Each 
+authorization checker (i.e. the ``security.authorization_checker`` service). Each
 one decides if the current user should have access to some resource.
 
 Ultimately, Symfony uses one of three different approaches on what to do
@@ -116,18 +116,26 @@ the security layer.
 To recap, here's what's expected from the three abstract methods:
 
 The :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AbstractVoter::getSupportedClasses`
-method tells Symfony that your voter should be called whenever an object of one of the given classes
-is passed to `isGranted`  For example, if you return ['\Acme\DemoBundle\Model\Product'],
-Symfony will call your voter when a `Product` object is passed to `isGranted`.
+method tells Symfony that your voter should be called whenever an object of one
+of the given classes is passed to ``isGranted()``. For example, if you return
+``array('AppBundle\Model\Product')``, Symfony will call your voter when a
+``Product`` object is passed to ``isGranted()``.
 
 The :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AbstractVoter::getSupportedAttributes`
-method tells Symfony that your voter should be called whenever one of these strings is passes as the
-first argument to `isGranted`. For example, if you return `array('CREATE', 'READ')`, then
-Symfony will call your voter when one of these is passed to `isGranted`.
+method tells Symfony that your voter should be called whenever one of these
+strings is passed as the first argument to ``isGranted()``. For example, if you
+return ``array('CREATE', 'READ')``, then Symfony will call your voter when one
+of these is passed to ``isGranted()``.
 
 The :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AbstractVoter::isGranted`
 method must implement the business logic that verifies whether or not a given
-user is allowed access to a given attribute on a given object. This method must return a boolean.
+user is allowed access to a given attribute (e.g. ``CREATE`` or ``READ``) on a
+given object. This method must return a boolean.
+
+.. note::
+
+    Currently, to use the ``AbstractVoter`` base class, you must be creating a
+    voter where an object is always passed to ``isGranted()``.
 
 Declaring the Voter as a Service
 --------------------------------
@@ -206,7 +214,8 @@ from the authorization checker is called.
     }
 
 .. versionadded:: 2.6
-    The ``security.authorization_checker`` service was introduced in Symfony 2.6. Prior
-    to Symfony 2.6, you had to use the ``isGranted()`` method of the ``security.context`` service.
+    The ``security.authorization_checker`` service was introduced in Symfony 2.6.
+    Prior to Symfony 2.6, you had to use the ``isGranted()`` method of the
+    ``security.context`` service.
 
 It's that easy!