symfony
diff --git a/‎cookbook/bundles/best_practices.rst
Copy file name to clipboardExpand all lines: cookbook/bundles/best_practices.rst
+53Lines changed: 53 additions & 0 deletions b/‎cookbook/bundles/best_practices.rst
Copy file name to clipboardExpand all lines: cookbook/bundles/best_practices.rst
+53Lines changed: 53 additions & 0 deletions
diff --git a/‎cookbook/configuration/override_dir_structure.rst
Copy file name to clipboardExpand all lines: cookbook/configuration/override_dir_structure.rst
+3-2Lines changed: 3 additions & 2 deletions b/‎cookbook/configuration/override_dir_structure.rst
Copy file name to clipboardExpand all lines: cookbook/configuration/override_dir_structure.rst
+3-2Lines changed: 3 additions & 2 deletions
diff --git a/‎cookbook/form/unit_testing.rst
Copy file name to clipboardExpand all lines: cookbook/form/unit_testing.rst
+5-1Lines changed: 5 additions & 1 deletion b/‎cookbook/form/unit_testing.rst
Copy file name to clipboardExpand all lines: cookbook/form/unit_testing.rst
+5-1Lines changed: 5 additions & 1 deletion
@@ -194,6 +194,59 @@ Extensive documentation should also be provided in the
 the ``Resources/doc/`` directory; the ``Resources/doc/index.rst`` file is
 the only mandatory file and must be the entry point for the documentation.
 
+Installation Instructions
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to ease the installation of third-party bundles, consider using the
+following standardized instructions in your ``README.md`` file.
+
+.. code-block:: text
+
+    Installation
+    ============
+
+    Step 1: Download the Bundle
+    ---------------------------
+
+    Open a command console, enter your project directory and execute the
+    following command to download the latest stable version of this bundle:
+
+    ```bash
+    $ composer require <package-name> "~1"
+    ```
+
+    This command requires you to have Composer installed globally, as explained
+    in the [installation chapter](https://getcomposer.org/doc/00-intro.md)
+    of the Composer documentation.
+
+    Step 2: Enable the Bundle
+    -------------------------
+
+    Then, enable the bundle by adding the following line in the `app/AppKernel.php`
+    file of your project:
+
+    ```php
+    <?php
+    // app/AppKernel.php
+
+    // ...
+
+    public function registerBundles()
+    {
+        $bundles = array(
+            // ...
+            return new <vendor>\<bundle-name>\<bundle-long-name>(),
+        );
+    }
+    ```
+
+This template assumes that your bundle is in its ``1.x`` version. If not, change
+the ``"~1"`` installation version accordingly (``"~2"``, ``"~3"``, etc.)
+
+Optionally, you can add more installation steps (*Step 3*, *Step 4*, etc.) to
+explain other required installation tasks, such as registering routes or
+dumping assets.
+
 Routing
 -------
 
 
@@ -147,9 +147,10 @@ file:
                 'read_from' => '%kernel.root_dir%/../../public_html',
             ));
 
-    Now you just need to dump the assets again and your application should
+    Now you just need to clear the cache and dump the assets again and your application should
     work:
 
     .. code-block:: bash
-
+    
+        $ php app/console cache:clear --env=prod
         $ php app/console assetic:dump --env=prod --no-debug
@@ -177,18 +177,22 @@ on other extensions. You need add those extensions to the factory object::
     use Symfony\Component\Form\Forms;
     use Symfony\Component\Form\FormBuilder;
     use Symfony\Component\Form\Extension\Validator\Type\FormTypeValidatorExtension;
+    use Symfony\Component\Validator\ConstraintViolationList;
 
     class TestedTypeTest extends TypeTestCase
     {
         protected function setUp()
         {
             parent::setUp();
+            
+            $validator = $this->getMock('\Symfony\Component\Validator\ValidatorInterface');
+            $validator->method('validate')->will($this->returnValue(new ConstraintViolationList()));
 
             $this->factory = Forms::createFormFactoryBuilder()
                 ->addExtensions($this->getExtensions())
                 ->addTypeExtension(
                     new FormTypeValidatorExtension(
-                        $this->getMock('Symfony\Component\Validator\ValidatorInterface')
+                        $validator
                     )
                 )
                 ->addTypeGuesser(
Original file line number	Diff line number	Diff line change
`@@ -177,18 +177,22 @@ on other extensions. You need add those extensions to the factory object::`
`177`	`177`	`use Symfony\Component\Form\Forms;`
`178`	`178`	`use Symfony\Component\Form\FormBuilder;`
`179`	`179`	`use Symfony\Component\Form\Extension\Validator\Type\FormTypeValidatorExtension;`
	`180`	`+ use Symfony\Component\Validator\ConstraintViolationList;`
`180`	`181`
`181`	`182`	`class TestedTypeTest extends TypeTestCase`
`182`	`183`	`{`
`183`	`184`	`protected function setUp()`
`184`	`185`	`{`
`185`	`186`	`parent::setUp();`
	`187`	`+`
	`188`	`+ $validator = $this->getMock('\Symfony\Component\Validator\ValidatorInterface');`
	`189`	`+ $validator->method('validate')->will($this->returnValue(new ConstraintViolationList()));`
`186`	`190`
`187`	`191`	`$this->factory = Forms::createFormFactoryBuilder()`
`188`	`192`	`->addExtensions($this->getExtensions())`
`189`	`193`	`->addTypeExtension(`
`190`	`194`	`new FormTypeValidatorExtension(`
`191`		`- $this->getMock('Symfony\Component\Validator\ValidatorInterface')`
	`195`	`+ $validator`
`192`	`196`	`)`
`193`	`197`	`)`
`194`	`198`	`->addTypeGuesser(`