add some comments about the usage of the bundle

Author: dmaicher

app/AppKernel.php

@@ -36,7 +36,9 @@ public function registerBundles()
             $bundles[] = new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle();
 
             if ($this->getEnvironment() === 'test') {
-                $bundles[] = new \DAMA\DoctrineTestBundle\DAMADoctrineTestBundle();
+                // this bundle is used to have isolated phpunit tests when interacting with doctrine & the database
+                // and is therefore only loaded for the 'test' environment
+                $bundles[] = new DAMA\DoctrineTestBundle\DAMADoctrineTestBundle();
             }
         }
 

tests/AppBundle/Controller/Admin/BlogControllerTest.php

@@ -79,6 +79,13 @@ public function testAdminBackendHomePage()
         );
     }
 
+    /**
+     * This test will manipulate the database state by deleting a Post.
+     * All changes to the database are rolled back before the next test case is executed.
+     * This is done by using https://github.com/dmaicher/doctrine-test-bundle.
+     *
+     * Therefore in the following test case we can edit the Post with ID=1 although we deleted it in this test.
+     */
     public function testAdminDeletePost()
     {
         $client = $this->getAdminClient();