Merge pull request DATA-DOG#31 from chancegarcia/documentation

Resolves Example for labeler DATA-DOG#11

docs/labeler.md

@@ -0,0 +1,52 @@
+#Setting a Labeler
+
+Create a Labeler class/method.
+
+\AppBundle\Labler\AuditLabler
+
+    namespace AppBundle\Labler;
+
+    use Symfony\Component\Security\Core\User\UserInterface;
+
+    class AuditLabler
+    {
+        public static function getLabel( $entity) {
+            if ($entity instanceof UserInterface) {
+                return $entity->getUsername();
+            }
+
+            return 'Unlabeled';
+        }
+    }
+
+Re-define the audit subscriber service to call the `setLabler` method of the AuditSubscriber with the [callable](http://php.net/manual/en/language.types.callable.php).
+
+app/config/config.yml
+
+    services:
+        ...
+        datadog.event_subscriber.audit:
+            class: 'DataDog\AuditBundle\EventSubscriber\AuditSubscriber'
+            arguments: ["@security.token_storage"]
+            tags:
+              - { name: doctrine.event_subscriber, connection: default }
+            calls:
+                - ['setLabeler', [['\AppBundle\Labler\AuditLabler', 'getLabel']]]
+        ...
+        
+or define in your services file
+
+app/config/services.xml
+
+    ...
+    <service id="datadog.event_subscriber.audit" class="DataDog\AuditBundle\EventSubscriber\AuditSubscriber">
+        <argument type="service" id="security.token_storage"/>
+        <tag name="doctrine.event_subscriber"/>
+        <call method="setLabeler">
+            <argument type="collection">
+                <argument>\AppBundle\Labler\AuditLabler</argument>
+                <argument>getLabel</argument>
+            </argument>
+        </call>
+    </service>
+    ...

example/src/AppBundle/Controller/DoctrineControllerTrait.php

@@ -2,8 +2,17 @@
 
 namespace AppBundle\Controller;
 
+use Doctrine\ORM\EntityManager;
+
+/**
+ * Trait DoctrineControllerTrait
+ * @package AppBundle\Controller
+ *
+ * @method \Doctrine\Bundle\DoctrineBundle\Registry getDoctrine()
+ */
 trait DoctrineControllerTrait
 {
+
     private function persist(...$entities)
     {
         foreach ($entities as $entity) {
@@ -23,6 +32,10 @@ private function remove(...$entities)
         }
     }
 
+    /**
+     * @param $class
+     * @return \Doctrine\Common\Persistence\ObjectRepository|EntityManager
+     */
     private function repo($class)
     {
         return $this->getDoctrine()->getManager()->getRepository($class);